查看: 88|回复: 3

pip install下载慢解决:临时与永久配置国内源

[复制链接]
发表于 20 分钟前 | 显示全部楼层 |阅读模式
在 Python 项目里执行 pip install 时,pip 默认请求的是官方 PyPI 源,网络条件不理想时经常表现为下载缓慢甚至中途失败。原文给出的解决思路只有两条:用 -i 参数临时换源,或写配置文件永久换源。下面把两种方式的位置、写法和生效范围整理成可以直接复制的操作步骤。

一、临时换源:-i 参数只对当前这条命令生效

在 pip install 命令后面追加 -i 选项,把尖括号里的占位符换成真实包名即可。原文示例使用的是清华源:
  1. pip install <package_name> -i https://pypi.tuna.tsinghua.edu.cn/simple
复制代码

这里最关键的是生效范围:-i 属于单次命令参数,命令执行完不会留下任何配置,下一条 pip install 仍然回到官方源。所以它适合一次性验证某个镜像是否可用,或临时安装一两个包;如果每次安装都要手动补 -i,就说明该改用永久配置了。

二、永久换源:由 pip 配置文件中的 index-url 生效

永久方式不修改命令,而是让 pip 每次启动时读取配置文件里的 index-url。文件所在的目录和文件名按操作系统区分。

Windows 系统

先在用户目录下创建一个名为 pip 的文件夹(原文举例为 C:\\Users\\YourUsername\\pip),然后在该文件夹中新建 pip.ini,写入:
  1. [global]
  2. index-url = https://pypi.tuna.tsinghua.edu.cn/simple
复制代码

Linux 和 macOS 系统

在用户目录下创建 .pip 文件夹(若不存在则先创建),然后在该文件夹中新建 pip.conf,写入同样的内容:
  1. [global]
  2. index-url = https://pypi.tuna.tsinghua.edu.cn/simple
复制代码

两处配置内容完全一致,都是 [global] 段加 index-url 键,区别只在目录名(pip 与 .pip)、文件名(pip.ini 与 pip.conf)以及 Windows 使用反斜杠路径。配置写好之后再执行 pip install <package_name>,无需任何额外参数,所有安装操作都会走镜像地址,这正是原文所说“对所有安装操作生效”的含义。

三、镜像地址可以替换

原文提到,除清华源之外还有常用的阿里云源 https://mirrors.aliyun.com/pypi/simple/ ,可以根据需要替换 index-url 的取值,其他写法保持不变:
  1. [global]
  2. index-url = https://mirrors.aliyun.com/pypi/simple/
复制代码

四、两种方式的取舍与排查顺序

按原文给出的定位,临时方式的作用域是“仅对当前命令有效”,永久方式的作用域是“对所有安装操作生效”。因此合理的做法是:先用带 -i 的单条命令确认镜像地址在本地网络下确实能拉到包,再把同一个地址写进配置文件,这样能避免把不可用的地址固化成全局配置。

如果永久配置写好后下载速度没有变化,可以按下面的顺序核对,这些点都能从原文的配置结构直接推导:其一,目录名是否正确,Windows 是 pip,Linux 与 macOS 是 .pip,后者被创建为隐藏目录;其二,文件名是否正确,Windows 用 pip.ini,Linux 与 macOS 用 pip.conf,写错文件名 pip 不会读取;其三,配置段名是否为 [global]、键名是否为 index-url,拼写偏差会导致该项被忽略。核对无误后,用一条普通的 pip install <package_name> 观察实际请求地址即可确认配置已经接管。

小结

原文给出的方案本质上是 pip 的 index-url 覆盖机制:命令行 -i 覆盖一次,配置文件覆盖全局。安装少量包或临时验证镜像时用 -i;需要长期在本地开发环境稳定拉包时,就按系统在用户目录建立 pip/pip.ini 或 .pip/pip.conf,写入 [global] 段与 index-url,并按网络情况在清华源与阿里云源之间切换。
回复

使用道具 举报

发表于 15 分钟前 | 显示全部楼层

Re: pip install下载慢解决:临时与永久配置国内源

感谢整理,步骤写得挺清楚的,尤其是把临时和永久两种方式的作用域单独拎出来说,这点很关键,很多人就是没搞明白 -i 不会留下配置。 补充几个我实际用下来觉得有用的小点。首先是排查配置到底有没有生效,不用猜,直接跑 pip config list 就能看到当前生效的项,再跑 pip config debug 会把你系统上 pip 查找的所有配置文件位置和加载情况都列出来,哪一层写错了、哪个文件根本没被读到,一眼就看出来了,比手动去对目录名和文件名快很多。其次优先级顺序记住就行:命令行参数高于环境变量,环境变量高于配置文件,所以临时想换个源其实还有个不用改命令的写法,就是设置 PIP_INDEX_URL 环境变量,切来切去比每次补 -i 省事,关掉终端或者 unset 就恢复了。 另外配置文件里其实不只有 index-url 一个键,遇到镜像偶尔卡住或者超时的情况,加一行 timeout 给个大点的秒数会稳一些;如果用的是走 http 的内网镜像,可能还得配 trusted-host,不然会报证书相关的错。还有一点,如果是那种一个项目一个虚拟环境的工作方式,pip 也会读虚拟环境目录下的配置文件,优先于用户目录的全局配置,这样就能做到项目级别单独指定源,不同项目互不干扰。 最后认同楼主那个排查思路,先用 -i 在本地网络实测一遍,确认能拉到包再写进配置,这个顺序很重要,不然把一个不通的地
回复 支持 反对

使用道具 举报

发表于 15 分钟前 | 显示全部楼层

Re: pip install下载慢解决:临时与永久配置国内源

楼主这篇整理得挺清楚,临时和永久这两条路的边界划得很明白。我之前一直是每次装包手动补参数,看到"如果每次安装都要手动补 -i,就说明该改用永久配置了"这句挺有共鸣的,确实该把配置固定下来。 几点觉得特别实用:一是按系统区分目录名和文件名那段,pip 和 .pip、pip.ini 和 pip.conf 这种细节最容易踩坑,写完不生效多半就出在这里;二是先用 -i 验证镜像在本地网络能不能拉到包,再把同一个地址写进配置文件,这个顺序很稳,能避免把一个不通的源固化成全局配置;三是最后那个排查顺序,段名、键名、目录名、文件名挨个核对,比乱试快多了。另外镜像地址可以换这一点也提醒得好,清华源和阿里云源按网络情况切换就行。 已经存到笔记里了,以后换机器或重装环境直接照这个结构抄配置,省得每次再查。感谢分享。
回复 支持 反对

使用道具 举报

发表于 15 分钟前 | 显示全部楼层

Re: pip install下载慢解决:临时与永久配置国内源

楼主这篇整理得挺清楚,尤其是把“临时 -i 只对当前命令生效”和“配置文件对全局生效”这两者的作用域单独拎出来讲,比原文那种一句话带过要实用得多,排查顺序那一段也很到位,目录名、文件名、段名、键名依次核对,基本能覆盖写错配置的常见情况。 有一点想提醒后面照着做的朋友:配置文件里 index-url 是需要放在一个段落标题下面的,一般就是 global 那一段,帖子里的配置示例中这个标题好像没显示出来,实际写入时要把段落标题和 index-url 两行都写上,只写一行 index-url 有可能不被识别。 另外补充一点经验,先临时用 -i 验证再固化到配置文件这个思路确实稳妥,反过来直接在配置文件里试错,一旦镜像地址不可用,后面的安装都会跟着卡,排查起来反而更麻烦。镜像地址在清华和阿里云之间切换时,配置文件的其余部分完全不用动,这点帖子里也讲明白了。总体是一份可以照着抄的操作笔记,感谢整理。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-20 03:20 , Processed in 0.023990 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部