Python 3.12安装后pip下载慢？Windows配置国内镜像源加速教程

在 Windows 环境下新安装 Python 3.12 之后，使用 pip install 安装第三方扩展库时，常常会遇到下载速度仅几 KB/s、进度条停滞不前，甚至直接抛出 ReadTimeoutError 网络连接超时错误的情况。这一现象的核心原因在于 pip 默认请求海外官方软件源（PyPI），受跨国骨干链路与物理距离影响容易发生高延迟与丢包。解决该问题的根本方案，是将 pip 的索引地址指向国内高校或云服务商维护的高速镜像站点。本文将全面梳理单次临时加速、全局命令行永久配置以及手动编辑 pip.ini 文件的完整操作流程与排错方案。

一、为什么 Python 3.12 的 pip 下载会异常缓慢

Python 3.12 引入了更严格的标准库网络协议检查与更新的 pip 发行版（通常内置 pip 23.2 及以上）。当读者刚安装完成并首次在命令行中键入包安装指令时，底层经历了以下逻辑：

• 默认寻址机制：pip 安装第三方库时，会向 https://pypi.org/simple/ 发送查询，获取包的元数据与 wheel 二进制包下载链接。
• 物理节点距离远：官方 PyPI 的文件实际托管在 Fastly CDN 与 AWS 北美/欧洲存储桶上。在国内直接访问时，受出口网关高峰期拥塞影响，延迟通常在 300ms 以上，且丢包率高。
• 严格超时截断：pip 默认内置的 socket 请求超时阈值通常在 15 秒左右。当网络吞吐速度无法维持连接时，控制台便会输出典型的错误追踪栈：

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out. (read timeout=15)")'

国内诸多知名高校和云计算大厂同步搭建了 PyPI 的双向完整镜像源，定时从官方同步所有合规包，并在国内各省市部署了高速 CDN 节点。将下载通道改用国内镜像，即可实现与本地局域网相近的下载速度。

二、常用的国内稳定 PyPI 镜像源列表

在配置前，读者可根据自身网络运营商（电信、联通、移动或教育网）选择最适合的镜像源。各大镜像站点的 Simple 索引地址如下：

三、方案一：单次命令临时加速（免配置快速应急）

如果当前只需安装某一个特定包，或者身处特定临时环境不希望修改全局系统配置，可以使用 -i（或 --index-url）参数指定单次下载源。

使用方法与示例

打开 Windows 终端（PowerShell 或 CMD），在安装命令后加上 -i 以及镜像地址。例如安装常用的网络请求库 requests：

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

如果遇到某些老旧环境提示未认证主机或证书警告，可追加 --trusted-host 参数显式信任该域名：

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

四、方案二：命令行全局设置（官方推荐，最便捷规范）

自 pip 10.0 版本起，官方提供了内建的 pip config 命令行配置工具。在 Python 3.12 中，这是最安全、最推荐的方式，因为它能自动计算 Windows 系统的用户漫游目录，自动创建缺失的父文件夹，完全杜绝了手工新建文件时的误操作。

1. 执行设置命令

按下快捷键 Win + R，输入 powershell 或 cmd 打开命令行窗口（普通用户权限即可，无需以管理员身份运行）。输入以下命令并回车：

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

命令执行后，终端将直接反馈写入的文件物理路径与键值内容，例如：

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

2. 补充配置信任主机与超时时限（推荐）

为了保证在企业内网代理或证书不完整环境下依然畅通无阻，同时预防下载大体积科学计算库（如 NumPy、PyTorch 等）因网络波动断开，可继续追加设置信任域名与延长超时时间：

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

3. 查看与验证配置列表

设置完毕后，通过 list 子命令核对：

pip config list

终端若正确回显如下三行，即代表全局加速已全量生效：

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

五、方案三：手动创建与编写 pip.ini 配置文件

如果读者希望直接在图形界面下查看或管理配置文件，或者需要批量为机房/团队机器分发统一配置文件，可以直接在 Windows 规定路径下手动创建 pip.ini。

1. 寻找配置路径

Windows 体系中，针对当前登录用户的全局 pip 配置文件的标准存放路径为：

C:\Users\<您的用户名>\AppData\Roaming\pip\pip.ini

由于 AppData 文件夹在 Windows 中默认处于隐藏状态，读者可以通过以下快捷方式进入：

1. 按 Win + R 唤起“运行”对话框；
2. 在输入框中键入 %APPDATA%，点击“确定”，系统将直接打开 C:\Users\<用户名>\AppData\Roaming 目录；
3. 查看该目录下是否存在名为 pip 的文件夹。若不存在，请右键选择“新建” -> “文件夹”，命名为 pip；
4. 双击进入 pip 文件夹。

2. 创建并填写 pip.ini

在 pip 文件夹空白处右键新建一个文本文件，并将其完整名称重命名为 pip.ini。使用记事本或任意代码编辑器打开该文件，粘贴如下推荐配置：

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

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

保存文件并关闭。系统日后调用任何 pip 指令均会自动读取此配置。

六、下载加速效果测试与多源切换

完成上述配置后，无需重启计算机，所有新开的终端会话均会即刻生效。

1. 实际测速

在命令行运行安装测试：

pip install requests

此时控制台显示的下载地址应已变更为清华镜像源域名，并且在极短时间内完成依赖解析与轮子包解压：

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)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 62.6/62.6 kB 2.1 MB/s eta 0:00:00
Installing collected packages: urllib3, idna, charset-normalizer, certifi, requests
Successfully installed certifi-2024.2.2 charset-normalizer-3.3.2 idna-3.6 requests-2.31.0 urllib3-2.2.1

2. 切换至其他镜像源或恢复默认

如果因某些网络波动需要改用阿里云镜像源，只需再次执行：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set install.trusted-host mirrors.aliyun.com

若未来希望完全恢复官方默认源，执行 unset 即可清除自定义配置：

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

七、Python 3.12 环境下的关键注意事项

在 Windows 环境下维护 Python 3.12 的包生态时，有以下几点需要特别留意：

• 虚拟环境（venv）的继承关系：使用 python -m venv myenv 创建的独立虚拟环境，默认会继承当前 Windows 登录用户 %APPDATA%\pip\pip.ini 中的全局配置，无需在每个虚拟环境中重复配置镜像源。
• 极新版本包的同步延迟：国内镜像源通常有 5 至 30 分钟不等的同步轮询周期。如果某 Python 库刚刚在官方发布了全新次版本，而国内镜像源尚未完成同步，此时可能会报 No matching distribution found。遇到此类情况，只需使用 -i https://pypi.org/simple 临时单次切换回官方源即可。
• pip 缓存机制：Python 3.12 的 pip 默认会缓存已下载的 wheel 包（位于 %LOCALAPPDATA%\pip\cache）。如果之前因断网中断过下载，偶尔会出现缓存损坏提示，可通过运行 pip cache purge 一键清空残留缓存。

通过合理配置国内镜像源，Windows 用户在 Python 3.12 环境下进行包管理时的网络瓶颈将得到彻底消除，从而大幅提升项目依赖部署与日常学习开发的效率。