pip 使用国内镜像源：临时指定与永久配置

pip 默认从国外的 https://pypi.org/simple 下载 Python 包。在国内网络环境下，直接访问 PyPI 官方源的速度通常很慢，安装大型包（如 NumPy、Pandas、PyTorch）时经常会超时失败。通过切换到国内镜像源，可以将下载速度提升数倍甚至数十倍，显著改善开发体验。

一、临时指定镜像源

如果只是偶尔需要加速下载，可以在安装命令后加 -i 参数临时指定镜像源：

pip3 install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple

这种方式只对当前命令生效，不会影响后续的 pip 操作。适合以下场景：

在服务器或共享环境中不想修改全局配置
只是临时测试某个镜像源的速度
安装单个包时偶尔需要加速

提示：部分镜像源使用 HTTPS，如果遇到 SSL 证书验证问题，可以追加 --trusted-host 参数，例如：pip3 install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn

二、设为默认镜像源

如果希望每次使用 pip 都自动走国内镜像，可以通过 pip config 命令设置全局默认源。

先升级 pip

建议先将 pip 升级到最新版本：

python -m pip install --upgrade pip

如果网络较差，连升级 pip 都很慢，可以临时用镜像源来升级：

python -m pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple --upgrade pip

设置默认源

升级完成后，执行以下命令将清华源设为默认：

pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

设置成功后，以后所有 pip install 命令都会自动从清华源下载，无需再手动指定 -i 参数。

三、通过配置文件修改

除了使用 pip config set 命令，也可以直接手动编辑配置文件。效果完全相同。

Linux / macOS

配置文件路径为 ~/.pip/pip.conf。如果目录不存在，先创建：

mkdir -p ~/.pip

然后编辑 ~/.pip/pip.conf，写入以下内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

Windows

配置文件路径为 C:\Users\用户名\pip\pip.ini（将"用户名"替换为你的 Windows 登录名）。

如果目录不存在，先创建 C:\Users\用户名\pip 文件夹，然后在该文件夹下新建 pip.ini 文件，写入以下内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

注意：Windows 下是 pip.ini，Linux/macOS 下是 pip.conf，文件名不同，但内容格式一致。

四、查看当前镜像配置

设置完成后，可以通过以下命令查看当前 pip 的配置信息，确认镜像源是否生效：

pip3 config list

输出示例：

global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'

如果看到 global.index-url 指向你配置的镜像地址，说明配置已生效。

五、常用国内镜像源列表

以下是国内常用的 PyPI 镜像源，你可以根据网络情况选择速度最快的一个：

镜像源	地址
清华大学	`https://pypi.tuna.tsinghua.edu.cn/simple`
阿里云	`https://mirrors.aliyun.com/pypi/simple/`
中国科学技术大学	`https://pypi.mirrors.ustc.edu.cn/simple/`
华为云	`https://repo.huaweicloud.com/repository/pypi/simple`
腾讯云	`https://mirrors.cloud.tencent.com/pypi/simple`

将上表中的地址替换到 pip config set global.index-url 命令或配置文件的 index-url 字段即可。建议优先使用清华源或阿里云源，这两者的同步频率和稳定性较好。