Python pip下载速度慢？更换国内镜像源加速安装教程

巷口听风

发布时间：2026-10-24 | 5人浏览过

原创

在使用 Python 安装依赖包时，经常会遇到 pip install 进度条停滞、下载速度仅有几十 KB/s 甚至直接触发 ReadTimeoutError 的情况。出现该现象的核心原因在于 pip 默认从海外官方 PyPI 服务器下载软件包；由于跨国链路带宽限制与网络抖动，下载体量较大的安装包（如 torch、tensorflow、pandas 等）时极易变慢或中断。将 pip 指向国内高校或主流云厂商搭建的 PyPI 同步镜像源，可以直接走国内骨干网络高速下载，速度可从几十 KB/s 提升到每秒数 MB 乃至数十 MB。

一、为什么 pip 下载速度慢与国内镜像源原理

pip 在未做任何额外配置时，其默认安装索引源为官方仓库 https://pypi.org/simple。国内各大科研机构和云服务商定期（通常每隔数分钟或数十分钟）将官方仓库的软件包全量镜像同步到国内服务器。当开发者将 pip 的索引地址修改为国内镜像后，所有的检索请求与二进制 wheel 包下载均转由国内机房或 CDN 节点提供，大幅缩短了网络传输往返时间（RTT），彻底摆脱跨国链路带来的丢包与限速瓶颈。

Python pip下载速度慢？更换国内镜像源加速安装教程 — 图 1：pip 官方源与国内镜像源下载请求链路与速率对比

二、常用国内主流镜像源地址汇总

目前国内有多家机构和云厂商提供高质量、高可用的 PyPI 镜像服务。不同镜像源在不同地区的网络营运商（电信、联通、移动、校园网）表现略有细微差异，但整体均能提供极为可观的加速效果：

镜像源机构	镜像地址（Simple Index）	特点与推荐场景
清华大学 (TUNA)	`https://pypi.tuna.tsinghua.edu.cn/simple`	更新频率极高，校园网与普通宽带均极稳定，社区首选推荐。
阿里云 (Alibaba Cloud)	`https://mirrors.aliyun.com/pypi/simple/`	拥有覆盖全国的 CDN 节点加速，企业及通用网络表现卓越。
中国科学技术大学 (USTC)	`https://pypi.mirrors.ustc.edu.cn/simple/`	老牌开源镜像站，同步机制成熟，高校及科研场景常用。
腾讯云 (Tencent Cloud)	`https://mirrors.cloud.tencent.com/pypi/simple/`	公网与云主机内部访问均非常迅速，大文件下载吞吐高。
华为云 (Huawei Cloud)	`https://repo.huaweicloud.com/repository/pypi/simple/`	电信与联通网络加速明显，镜像同步周期短。

三、方法一：临时指定镜像源安装（单次生效）

如果只是偶尔需要安装一个体量偏大的库，或者不希望修改全局系统配置，可以在执行 pip install 时通过 -i 参数临时指定镜像源地址。

1. 基本命令格式

pip install <包名> -i <国内镜像源URL>

2. 完整操作示例

例如临时通过清华大学镜像源安装常用的 requests 库：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

执行后终端会输出类似于以下内容的连接过程，可以看到下载链接直接指向了 pypi.tuna.tsinghua.edu.cn：

Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
Collecting requests
  Downloading https://pypi.tuna.tsinghua.edu.cn/packages/.../requests-2.31.0-py3-none-any.whl (62 kB)
Installing collected packages: requests
Successfully installed requests-2.31.0

注意：如果当前运行环境的系统根证书较为陈旧，可能会出现 SSL 验证告警或报错。此时可以附加 --trusted-host 参数将该镜像源域名加入信任白名单：
pip install requests -i http://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn

四、方法二：使用 pip 命令行永久换源（推荐）

对于绝大多数开发者而言，每次安装都手动输入完整的镜像源 URL 非常繁琐。pip 自带内置的 config 子命令，允许通过一行命令将国内镜像源写入用户级配置文件中，该方法跨平台通用（Windows、macOS、Linux 均适用），无需手动查找和创建配置文件。

1. 执行设置命令

打开系统终端（Windows 上的 CMD 或 PowerShell，macOS 与 Linux 上的 Terminal），执行以下命令：

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

该命令执行完成后，终端会返回写入配置的物理路径，例如：

Writing to C:\Users\YourUsername\AppData\Roaming\pip\pip.ini

或在 macOS / Linux 上：

Writing to /Users/YourUsername/.config/pip/pip.conf

2. 补充配置信任主机（防止安全报错）

为了防止部分网络环境下因 SSL 证书链受限导致安装失败，建议同步将镜像域名设置为受信任主机：

pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn

3. 验证生效情况

执行以下命令查看当前所有已经生效的 pip 配置项：

pip config list

预期返回内容：

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

确认无误后，后续所有的 pip install 都不再需要输入任何额外参数，直接享受国内镜像加速。

五、方法三：手动创建与修改配置文件

如果当前环境中的 pip 版本较低不支持 config 命令，或者需要在没有交互式终端的脚本/容器镜像构建时直接写入文件，可以通过直接修改对应的配置文件来完成设置。

1. Windows 系统手动配置

按下快捷键 Win + R 打开运行窗口，输入 %APPDATA% 并回车。
在打开的文件夹（一般位于 C:\Users\<用户名>\AppData\Roaming）下，查看是否存在名为 pip 的文件夹；若无则新建一个名为 pip 的文件夹。
进入 pip 目录，新建一个文本文件，重命名为 pip.ini（注意检查文件扩展名，切勿保存为 pip.ini.txt）。
使用记事本打开该文件，粘贴上述标准 INI 内容并保存即可。

2. macOS / Linux 系统手动配置

在终端中直接运行以下三行命令，自动创建目录并将配置内容追加至文件中：

mkdir -p ~/.config/pip
cat <<EOF > ~/.config/pip/pip.conf
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

六、常见问题排查与进阶提示

1. 如何完全恢复官方默认源

如果后续由于某些原因需要恢复官方源（例如需要即刻下载刚刚推送到官方 PyPI 的最新开发包），可以直接执行配置删除命令：

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

执行后 pip 将立即恢复回官方缺省的 https://pypi.org/simple 索引。

2. 清理旧缓存以强制从镜像源重新拉取

如果此前在慢速下载过程中产生了损坏的 wheel 缓存文件，可能导致更换镜像源后依然报错。此时运行清理命令清空本地缓存即可：

pip cache purge

总结

通过更换国内镜像源加速 pip 是 Python 开发环境搭建的基本功。对于临时单个依赖安装，推荐使用 pip install <包名> -i <URL>；而对于个人开发机或生产环境机器，推荐直接执行 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple 写入用户级配置。合理利用国内镜像节点，能够彻底杜绝因网络延迟导致的构建超时，大幅提升日常开发与部署效率。