Python pip 国内镜像源大全 & 一键配置指南

作为 Python 开发，pip install 下载慢、超时、报错是高频痛点，核心原因是官方 PyPI 源在境外。本文整理国内稳定、高速的 pip 镜像源，覆盖临时使用、永久配置、多系统适配，直接复制即可用。

一、国内常用 pip 镜像源（稳定推荐）

注意：新版 pip 均支持 https，优先用加密地址，更安全。

二、临时使用国内源（单次生效）

安装包时直接指定镜像源，仅当前命令生效，不影响全局配置：

bash 运行

# 通用格式
pip install 包名 -i 镜像源地址 --trusted-host 镜像源域名

# 示例：安装 requests 用阿里云源
pip install requests -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

三、永久配置国内源（全局生效）

1. 命令行一键配置（最简单）

直接执行命令，自动写入配置文件，全系统通用：

bash 运行

# 配置阿里云源（推荐）
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set global.trusted-host mirrors.aliyun.com

# 配置清华源（可选）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

2. 手动配置文件（进阶）

Windows 系统

1. 打开 C:\Users\你的用户名\pip 文件夹（没有就新建 pip 文件夹）

2. 新建 pip.ini 文件，写入：

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

macOS / Linux 系统

1. 打开终端，创建配置目录：

bash 运行

mkdir ~/.pip

1. 编辑配置文件：

bash 运行

vim ~/.pip/pip.conf

1. 写入内容：

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

四、验证配置是否生效

执行命令查看当前源地址，确认配置成功：

bash 运行

pip config list

输出中出现你配置的国内源地址，即生效。

五、恢复官方默认源

如需切回官方源，执行命令即可：

bash 运行

pip config unset global.index-url
pip config unset global.trusted-host