pip 国内镜像源大全【测试 / 自动化开发常备】

- [1. 常用国内镜像源（优选排序）](#1. 常用国内镜像源（优选排序）)
- [2. 3种使用方式](#2. 3种使用方式)
- - [1. 临时换源（仅当前命令生效）](#1. 临时换源（仅当前命令生效）)
  - [2. 永久配置（全局生效）](#2. 永久配置（全局生效）)
- [3. 验证配置是否生效](#3. 验证配置是否生效)
- [4. 国内镜像升级并查看当前pip版本](#4. 国内镜像升级并查看当前pip版本)
- [5. 内网环境](#5. 内网环境)
- [6. 恢复官方源](#6. 恢复官方源)

pip 官方源（PyPI）在国外，国内访问时经常会遇到下载慢或连接超时的问题，换成国内镜像源是目前最通用的解决办法。

下面整理了国内几个主流镜像源的地址，附上配置方法，方便参考使用。

1. 常用国内镜像源（优选排序）

镜像站点	源地址	特点
清华源（TUNA）	https://pypi.tuna.tsinghua.edu.cn/simple	更新最快、包最全，通用首选
阿里云	https://mirrors.aliyun.com/pypi/simple/	企业稳定，云服务器推荐
腾讯云	https://mirrors.cloud.tencent.com/pypi/simple/	腾讯服务器环境最优
中科大	https://pypi.mirrors.ustc.edu.cn/simple/	科研稳定
华为云	https://repo.huaweicloud.com/repository/pypi/simple/	国内机房速度稳
豆瓣源	http://pypi.douban.com/simple/	老源，http 需加信任主机

豆瓣 http 源报错补充：--trusted-host pypi.douban.com

2. 3种使用方式

1. 临时换源（仅当前命令生效）

安装包时直接通过 -i 参数指定镜像源，适合偶尔加速或测试。

bash 复制代码

# 使用清华源安装 requests
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/

若镜像源使用 HTTP 协议，需额外添加 --trusted-host（新版 pip 一般不需要，但部分环境仍需）：

bash 复制代码

pip install requests -i https://pypi.doubanio.com/simple/ --trusted-host pypi.doubanio.com

2. 永久配置（全局生效）

经常使用 Python，建议永久配置，一次配置后续所有 pip 命令自动生效。

方式一：命令一键配置

bash 复制代码

# 设置清华全局源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 配置信任域名（消除ssl警告）
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

# 查看当前配置
pip config list

# 恢复官方默认源
pip config unset global.index-url

方式二：手动修改配置文件

Windows 系统：在 C:\Users\你的用户名\ AppData\Roaming\pip\pip.ini，无文件夹手动创建pip目录，写入以下内容

bash 复制代码

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

macOS / Linux 系统：在终端执行以下命令创建配置文件并写入镜像源地址：

bash 复制代码

mkdir -p ~/.pip
cat > ~/.pip/pip.conf << EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

3. 验证配置是否生效

配置完成后，可以通过以下命令查看当前 pip 使用的镜像源地址：

pip config list

输出中如果出现你配置的国内镜像地址，说明配置已生效。

4. 国内镜像升级并查看当前pip版本

python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple

查看当前pip版本

pip --version

5. 内网环境

在企业内网或代理环境下使用，可能需要额外配置代理，可通过:

pip config set global.proxy http://proxy.server:port 设置

6. 恢复官方源

如需切回 PyPI 官方源，执行 pip config unset global.index-url 即可