国内 Python 开发加速指南：PyPI 镜像源配置全攻略

本文教你彻底解决 pip install 超时问题，一劳永逸提升 Python 包安装速度！

📦 PyPI 是什么？

PyPI（Python Package Index）是 Python 官方第三方库仓库，相当于 Python 的“应用商店”。 所有开源包（如 NumPy、scikit-learn、requests）都托管在 https://pypi.org 上。

⚠️ 注意：pip 是下载工具，PyPI 是仓库。 默认情况下，pip install 会从 https://pypi.org/simple/ 下载包。

🇨🇳 国内访问问题

PyPI 服务器位于海外，国内直连常出现：

• 下载速度极慢

• 连接超时（ConnectTimeoutError）

• SSL 证书验证失败

✅ 解决方案：使用国内镜像源

国内镜像源每天自动同步 PyPI 内容，完全免费且安全。

方法一：临时使用（单次命令）

# 安装 scikit-learn 并指定阿里云镜像
pip install -U scikit-learn -i https://mirrors.aliyun.com/pypi/simple/
​
# 推荐加上 --trusted-host 避免 SSL 错误
pip install -U scikit-learn -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

方法二：永久设置（推荐！）

运行以下命令，所有后续 pip install 自动走阿里云：

powershell

# 设置镜像源（跨平台：Windows/macOS/Linux 均适用）
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
​
# 设置信任主机（防 SSL 错误）
pip config set global.trusted-host mirrors.aliyun.com

✅ 效果：以后只需 pip install numpy，无需再加 -i 参数！

🔍 验证配置

powershell

pip config list
# 输出应包含：
# global.index-url='https://mirrors.aliyun.com/pypi/simple/'
# global.trusted-host='mirrors.aliyun.com'

📂 配置文件位置（Windows）

text

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

内容示例：

ini

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

🔄 恢复官方源

powershell

pip config unset global.index-url
pip config unset global.trusted-host(若未设置trusted-host，则忽略这条命令)

或者直接删除配置文件：C:\Users\<用户名>\AppData\Roaming\pip\pip.ini

🌐 其他国内镜像源（备用）

表格

💡 提示：阿里云和清华源最稳定，推荐优先使用。