配置pip国内镜像源教程

如果你在Windows系统中用pip安装Python包时总是卡顿、超时或慢得令人抓狂，很可能是因为pip默认连接的是境外PyPI源——而这篇指南正是为你量身定制的提速方案：它详细介绍了五种简单可靠的配置国内镜像源方法（如清华、豆瓣、阿里云源），涵盖临时命令、用户级配置文件编辑、pip内置命令设置、环境变量修改，并提供清晰的验证步骤，帮你一键告别下载等待，让pip安装飞起来。

如果您在Windows系统中使用pip安装Python包时速度缓慢或连接超时，则可能是由于默认的PyPI源位于境外，网络延迟较高。以下是配置pip使用国内镜像源以加速下载的具体步骤：

一、临时使用镜像源安装单个包

该方法不修改全局配置，仅对当前命令生效，适用于快速测试或一次性安装需求。

1、按下 Win + R 打开运行窗口，输入 cmd 并回车启动命令提示符。

2、执行如下格式的命令，以清华镜像源为例安装 requests 包：

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

3、若需信任该镜像源（避免SSL警告），可追加 --trusted-host pypi.tuna.tsinghua.edu.cn 参数。

二、配置用户级pip.conf文件

该方式将镜像源设置为当前用户的默认源，不影响其他用户，且优先级高于全局配置。

1、在Windows资源管理器地址栏中输入 %APPDATA%\pip\ 并回车，进入pip配置目录。

2、若该路径不存在，手动创建文件夹：先新建 pip 文件夹，再在其内新建 pip.ini 文本文件。

3、用记事本打开 pip.ini，写入以下内容（以豆瓣源为例）：

[global]

index-url = https://pypi.douban.com/simple/

trusted-host = pypi.douban.com

三、通过pip命令直接配置全局镜像源

该方式利用pip内置的config命令写入配置，避免手动编辑文件可能产生的编码或路径错误。

1、在命令提示符中执行以下命令设置清华镜像源：

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

2、紧接着执行命令添加可信主机：

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

3、配置完成后，可通过 pip config list 查看当前生效的配置项。

四、修改环境变量启用镜像源

该方式通过系统级环境变量控制pip行为，适用于多用户环境或需要强制统一源的场景。

1、右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。

2、在“系统变量”区域点击“新建”，变量名为 PIP_INDEX_URL，变量值设为 https://mirrors.aliyun.com/pypi/simple/。

3、再新建一个系统变量，变量名为 PIP_TRUSTED_HOST，变量值设为 mirrors.aliyun.com。

4、重启所有已打开的命令提示符窗口使变量生效。

五、验证镜像源是否生效

该步骤用于确认配置已正确加载并实际作用于pip请求过程。

1、在命令提示符中执行 pip debug -v，查看输出中的 index-url 字段值是否为所设镜像地址。

2、执行 pip install -v some-package-name（如 pip install -v flask），观察日志中实际访问的URL是否指向国内镜像域名。

3、若安装过程中出现 Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple/ 提示，则表明镜像源已成功启用。

今天关于《配置pip国内镜像源教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！