最近在配置 Python 开发环境时特别是安装第三方库时网络问题往往是新手最容易遇到的拦路虎。下载速度慢、频繁断连甚至超时错误，让人抓狂。

一、为什么要配置镜像源？

PIP 默认连接国外官方源”，在国内网络环境下延迟高且不稳定。这直接导致：

• 下载大体积库时速度极慢。
• 网络波动会导致安装中途断线，出现 “ConnectionError” 或 “ReadTimeout”。
• PIP 超时重试多次仍失败，浪费大量时间。

A 方法就是把官方源替换为国内的高速镜像，从根本上消除这些痛点。

二、配置实战

说到临时救急，命令行指定 -i 参数

If you only need to install a couple of packages occasionally。add mirror URL directly in install command.

pip install numpy -i https://mirrors.aliyun.com/pypi/simple

This one‑off approach instantly bypasses slow overseas connection.

至于长治久安，使用 PIP config 设置全局默认值

If you want a permanent solution so that you never have to type -i…,configure pip globally.

1. 第一步先：设置主镜像源

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

2. 接下来：配置备用镜像源

The URLs must be separated by spaces and wrapped in double quotes on Windows.

pip config set global.extra-index-url "https://mirrors.aliyun.com/pypi/simple https://pypi.mirrors.ustc.edu.cn/simple"

The above two commands create a real configuration file under your user profile;no hidden environment variables are involved.

三、验证是否生效

1️⃣ 配置文件位置

Pip 将配置信息写入：

C:\Users\\AppData\Roaming\pip\pip.ini

You can open this file with any text editor to confirm two URLs have been recorded.

2️⃣ 终端验证

pip config list

The output should display both # global.index-url = …,and # global.extra-index-url = …,confirming that pip will now优先使用这些国内源。

四、主流国内镜像源一览

阿里云 

\\\\ // // \\\\
\\\\
​

​

Note: The above table contains only four most popular mirrors;you can add more according to your needs.

五、复盘与避坑教程

• URL 格式易错点： 镜像地址必须以 “/simple ”，否则会返回 404 错误。
• 字符串包裹： 在 Windows CMD 下设置多个备用源时忘记双引号，会导致解析错误。
• 优先级逻辑： `index‑url` 为首选；`extra-index-url` 为备选。若两个源都包含同名包，先尝试 `index‑url`。这解释了 “为什么装到了旧版本” 的常见困惑。
• 缓存问题： 修改完配置后如果仍然很慢，请执行 `pip cache purge` 清理本地缓存。
• 不同 Python 环境： 每个虚拟环境都有自己的 `pip.ini`，确保在激活对应 env 后再检查配置。
• 程序代理冲突： 某些公司网络需要代理。请先在程序或 `pip.ini` 中添加 `proxy = http://user:pwd@host:port`，否则即使换了国内镜像仍无法连通。
• Linux/macOS 方法差异： 对应的全局配置文件是 `~/.config/pip/pip.conf` 或 `/etc/pip.conf`，请根据网站选择合适位置。
• 升级 pip 本身： 老版本 pip 对 `extra-index-url` 的解析可能有 bug，建议先运行 `python -m pip install --upgrade pip` 再做上述操作。
• 权限问题： 在某些 Windows 环境下需要以管理员身份运行 cmd/PowerShell 才能写入 `C:\ProgramData\pip\pip.ini`。如果只想针对当前使用者，请确保方法指向 `%APPDATA%\pip\pip.ini`。
• 一次性切换回官方源： 临时想回到 PyPI，只需在安装命令中加上 `-i https://registry.npmjs.org/…，?`，怎么说呢，可以执行

   pip config unset global.index-url
  pip config unset global.extra-index-url