如何给 pip 更换国内源，并配置 Python 的国内镜像

最新推荐文章于 2025-03-24 10:01:55 发布

孽小倩

最新推荐文章于 2025-03-24 10:01:55 发布

阅读量2.2k

点赞数 17

分类专栏： python 文章标签： pip python 开发语言

本文链接：https://blog.csdn.net/i826056899/article/details/145612968

版权

python 专栏收录该内容

10 篇文章

订阅专栏

经常搞 Python 开发的小伙伴们可能会遇到一个常见问题：使用 pip 安装第三方库速度太慢，甚至有时候还会超时，原因多半是因为我们默认的 pip 源服务器在国外。为解决这类困扰，可以切换到国内的镜像源，享受更快的下载速度。今天这篇博客就来聊聊如何快速配置 pip 的国内源。

温馨提示：如果你是 Python 新手，可以先通过 python --version、pip --version 等命令确认好自己的 Python 和 pip 版本再进行操作。

1. 为什么要切换国内源？

下载速度更快：默认 pip 是从 Python 官方源（pypi.org）下载，网络状况不稳定，常常会出现下载速度慢或失败的情况。
稳定性更高：国内镜像一般都在国内服务器，连接更稳定，出错率也更低。
节省时间：加快依赖库的安装速度，在一定程度上能提高开发效率。

2. 常见的国内镜像源地址

这里列出几家常用的国内镜像源，大家可以根据自己的需要进行选择。

清华大学 TUNA：https://pypi.tuna.tsinghua.edu.cn/simple
阿里云：https://mirrors.aliyun.com/pypi/simple/
豆瓣(douban)：https://pypi.douban.com/simple/
中国科学技术大学(USTC)：https://pypi.mirrors.ustc.edu.cn/simple/

3. 临时使用国内源

如果仅是临时切换某一次安装，那么使用命令行中的 -i 参数就可以了。比如你打算从清华源安装 requests 库，可以这样做：

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

这条命令仅在这一次安装时生效，后续安装依旧会恢复默认的官方源。

4. 永久修改 `pip` 源

为了每次都能自动使用国内镜像，我们需要进行全局配置或用户级配置。步骤相对简单，以下展示三大系统的常用配置方式。

4.1 Windows 系统

创建配置文件
Windows 下默认的 pip 配置文件是 pip.ini 或者 pip.conf（不同 pip 版本可能稍有差异）。
- 通常建议放在：
```
C:\Users\<你的用户名>\AppData\Roaming\pip\pip.ini
```
  如果没有 pip 文件夹，可以手动创建。
写入镜像地址
打开或者新建 pip.ini，写入以下内容：
```
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
```
这里的 trusted-host 是为了避免某些版本下会提示证书不被信任的问题。
验证是否生效
你可以在命令行里输入：
```
pip config list
```
或者直接安装一个库试试看：
```
pip install flask
```
看看输出的 Looking in indexes 是否变成了你配置的国内源。

4.2 macOS / Linux 系统

在类 Unix 系统上（包括 macOS 和大多数 Linux 发行版），pip 的配置文件默认放置路径通常为 ~/.config/pip/pip.conf 或者 ~/.pip/pip.conf。

找到或新建配置文件

# 进入 .config 文件夹
cd ~/.config
# 如果没有 pip 目录就创建一个
mkdir -p pip
# 进入 pip 目录
cd pip
# 用你喜欢的编辑器来编辑 pip.conf，比如 nano、vi 或者其他
nano pip.conf

写入国内镜像地址
和 Windows 下类似，内容格式相同：

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

保存并测试
保存文件后，直接测试：
```
pip install flask
```
是否有 Looking in indexes 的提示。如果是你配置的国内源，说明生效成功。

5. 使用多个镜像源

有时候，我们可能会想要指定多个镜像源来防止某一个源出现故障。pip 并不支持直接合并多个 index-url，但是你可以配合 --extra-index-url 的参数来使用额外的索引。例如，在命令行临时使用：

pip install <库名> --index-url https://pypi.tuna.tsinghua.edu.cn/simple --extra-index-url https://mirrors.aliyun.com/pypi/simple

这样当清华源上没有找到对应包时，会去阿里云再尝试一次。

6. 常见问题与小技巧

pip 版本过旧
- 如果你的 pip 版本太老，可能不支持某些新特性，建议先升级：
```
pip install --upgrade pip
```
证书验证不通过
- 可以加上 trusted-host，或者将其写到配置文件中去。
- 如果实在不行，可以在命令行里加 --trusted-host pypi.tuna.tsinghua.edu.cn 之类的。
多环境冲突
- 有时候你可能有多个 Python 版本，或者用了 Anaconda、Miniconda。需要对每个环境的 pip 进行分别配置，或者使用环境专属的 pip.conf。
- 也可以在虚拟环境中使用临时指定源的方式安装，不会影响全局。
Linux 系统权限问题
- 有时全局安装需要 sudo，但也会导致一些权限问题。建议使用 --user 或者虚拟环境（如 venv）进行安装，以免跟系统包冲突。

以上就是关于如何更换 pip 国内源的简单教程。总结一下，最关键的就是找到配置文件路径，然后把 [global] 下的 index-url 改成国内镜像地址，就能享受更快更稳定的下载速度啦。如果你是 Python 重度使用者，建议长期配置国内源，既节省时间又不用每次手动敲命令。