Python 国内镜像源配置指南

在使用 Python 进行开发时，pip 是最常用的包管理工具。然而，由于网络原因，直接从官方 PyPI 源（https://pypi.org/simple）下载包常常速度缓慢甚至失败。为提升安装效率，国内许多高校和企业提供了 PyPI 镜像源，可以显著加快包的下载速度。

本文将详细介绍 Python 国内镜像源的常用地址、配置方法（临时与永久），并提供适用于 Windows、Linux 和 macOS 系统的操作指南，帮助你高效配置 pip 国内源。

---

一、常用国内镜像源

以下是国内稳定且广泛使用的 PyPI 镜像源，推荐优先选择清华大学或中国科学技术大学的源：

镜像源	地址
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple
中国科学技术大学	https://mirrors.ustc.edu.cn/pypi/web/simple/
阿里云	http://mirrors.aliyun.com/pypi/simple/
豆瓣	http://pypi.douban.com/simple/
华中理工大学	http://pypi.hustunique.com/
山东理工大学	http://pypi.sdutlinux.org/

⚠️ 注意：部分源使用 http 协议，可能存在安全风险，建议优先选择支持 https 的源。

---

二、配置方式

1. 临时使用镜像源（单次生效）

适用于偶尔需要加速安装某个包的场景，无需修改配置。

命令格式：

pip install <包名> -i <镜像源地址>

示例（使用清华源安装 pandas）：

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

若提示证书信任问题，可添加 --trusted-host 参数：

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

可选：设置超时时间（应对网络不稳定）：

pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn --default-timeout=600

✅ 优点：灵活，不影响全局配置
❌ 缺点：每次安装都需手动输入参数

---

2. 永久配置镜像源（推荐）

配置一次后，所有 pip install 命令默认使用指定镜像源，提升整体开发效率。

✅ 推荐方法：使用 pip config set 命令（现代、简洁、跨平台）

该方法无需手动创建文件，由 pip 自动管理配置。

设置全局镜像源（以清华源为例）：

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

设置信任主机（避免 HTTPS 警告）：

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

查看当前配置是否生效：

pip config list

输出应包含：

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

✅ 优点：操作简单、自动创建配置文件、兼容性强
❌ 缺点：需 pip 版本支持（建议使用 pip ≥ 10.0）

---

手动配置配置文件（适用于旧版本 pip 或自定义需求）

Windows 系统

1. 在用户目录下创建 pip 文件夹：
2. 在该目录下创建 pip.ini 文件，内容如下：

Linux / macOS 系统

1. 在用户主目录下创建 .pip 文件夹：
2. 创建并编辑 ~/.pip/pip.conf 文件：
3. 写入以下内容：

💡 提示：配置完成后，可通过 pip install <包名> 测试下载速度，确认是否已使用国内源。

---

三、验证配置是否生效

运行以下命令检查当前 pip 配置：

pip config list

或尝试安装一个包，观察下载链接是否来自你设置的镜像源：

pip install requests

如果看到类似以下输出，说明配置成功：

Downloading https://pypi.tuna.tsinghua.edu.cn/simple/requests/...

---

四、恢复默认官方源

如需恢复使用官方 PyPI 源，可执行以下命令：

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

或手动删除配置文件：

• Windows: 删除 C:\Users\<用户名>\pip\pip.ini
• Linux/macOS: 删除 ~/.pip/pip.conf

---

五、在 PyCharm 中使用镜像源

除了命令行配置，你也可以在 PyCharm 中设置包源：

1. 打开 File → Settings → Project → Python Interpreter
2. 点击右上角的 + 号添加包
3. 在搜索框上方，点击“Manage Repositories”
4. 添加镜像源地址，例如：https://pypi.tuna.tsinghua.edu.cn/simple
5. 保存后即可从该源安装包

📌 注意：此设置仅对当前项目生效，建议优先进行全局 pip 配置。

---

六、总结与建议

方法	适用场景	推荐指数
临时 -i 参数	偶尔使用、测试	⭐⭐⭐
pip config set 命令	推荐，永久生效	⭐⭐⭐⭐⭐
手动编辑配置文件	兼容旧环境	⭐⭐⭐⭐
PyCharm 图形界面设置	项目级配置	⭐⭐⭐

✅ 最佳实践建议：

1. 使用 pip config set 命令配置全局清华源；
2. 同时设置 trusted-host 避免证书问题；
3. 定期检查配置是否正常，必要时更新；
4. 在团队协作中，建议统一使用国内源以提升开发效率。

---

📌 温馨提示：镜像源会定期同步官方源，可能存在短暂延迟（通常几分钟到几小时），如需最新版本包，请关注同步状态。

希望本文能帮助你顺利配置 Python 国内镜像源，显著提升开发体验！🚀