
如果您在Windows系统中使用pip安装Python包时速度缓慢或连接超时,则可能是由于默认的PyPI源位于境外,网络延迟较高。以下是配置pip使用国内镜像源以加速下载的具体步骤:
一、临时使用镜像源安装单个包
该方法不修改全局配置,仅对当前命令生效,适用于快速测试或一次性安装需求。
1、按下 Win + R 打开运行窗口,输入 cmd 并回车启动命令提示符。
2、执行如下格式的命令,以清华镜像源为例安装 requests 包:
立即学习“Python免费学习笔记(深入)”;
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/ 提示,则表明镜像源已成功启用。

评论(0)