boxmoe_header_banner_img

Hope`Chen

加载中

文章导读

Python开发效率翻倍:PIP镜像源的配置与优化指南


avatar
haotianit 2026年1月7日 86
摘要
Python包安装慢得让人崩溃?别让默认源拖垮你的开发效率!本文手把手教你配置清华TUNA等国内镜像源,彻底解决PIP下载卡顿问题。从临时加速命令到永久设为默认,再到PDM、Poetry及Homebrew的专属配置方案,覆盖多工具场景。掌握这些技巧,包安装速度飙升,开发效率立竿见影提升。告别等待,即刻解锁流畅编程体验——3分钟搞定,从此告别"pip install"的漫长煎熬!
— 文章内容摘要

临时使用

pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple some-package

注意,simple 不能少。
pip 要求使用 https ,因此需要 https 而不是 http

设为默认

升级 pip 到最新的版本后进行配置:

python -m pip install --upgrade pip
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

如果您到 pip 默认源的网络连接较差,临时使用本镜像站来升级 pip:

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

配置多个镜像源

如果您想配置多个镜像源平衡负载,可在已经替换 index-url 的情况下通过以下方式继续增加源站:

pip config set global.extra-index-url "<url1> <url2>..."

请自行替换引号内的内容,源地址之间需要有空格, 例如:

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

PDM

通过如下命令设置默认镜像:

pdm config pypi.url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

Poetry

通过以下命令为单个项目设置首选镜像:

poetry source add --priority=primary mirrors https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/

通过以下命令为单个项目设置补充镜像:

poetry source add --priority=supplemental mirrors https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/

Poetry 尚未支持全局设置镜像。参考 issue 1632。

使用全局镜像的临时方案是将 Poetry 的安装器切换回 pip,如下所示。但该方式会在将来的版本中停止支持,参考 PR 7356。

poetry config experimental.new-installer false

Homebrew

本节主要供 Homebrew 帮助使用。

export HOMEBREW_PIP_INDEX_URL="https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"


评论(25)

查看评论列表
评论头像
方寸天 2026年01月12日
试了下清华源,下载快了好多👍
评论头像
不妥协的独狼 2026年01月12日
之前一直卡在下载那步,换镜像终于解决了
评论头像
杀戮之影 2026年01月12日
这个配置在M1芯片上能用吗?
评论头像
KazeRipple 2026年01月12日
poetry全局设置还是有点麻烦啊
评论头像
祁红岁月 2026年01月12日
用阿里云镜像也挺稳的
评论头像
SinisterHymn 2026年01月18日
阿里云确实稳,但清华源在国内有时候更快点
评论头像
SilentRevenant 2026年01月12日
第一次配镜像源,照着做成功了😊
评论头像
不被看见的星 2026年01月13日
为啥我加了extra-index-url还是报错?
评论头像
古道游侠 2026年01月17日
extra-index-url多个源之间空格分隔就行,我试过三个没问题
评论头像
影语星尘 2026年01月13日
之前被pip慢速折磨疯了,早该看这个的
评论头像
城隍威严 2026年01月15日
多个镜像源怎么选最优的?
评论头像
小飞侠Tom 2026年01月15日
简单实用,收藏了
评论头像
星空下的幻想师 2026年01月15日
这命令真救命,之前等半小时都下不完
评论头像
DuskStrider 2026年01月21日
M1上刚配完,没啥问题,pip install飞起
评论头像
人脉王 2026年01月22日
咱就是说,早几年出这教程能少踩多少坑啊
评论头像
影魔之息 2026年01月24日
多个源是轮询还是优先用第一个啊?
评论头像
桃红蜜语 2026年01月24日
poetry那个全局设置太反人类了,搞不懂为啥不早点支持
评论头像
旅途漫游者 2026年01月25日
家里网络抽风的时候换镜像简直救星
评论头像
狐语书匠 2026年01月26日
第一次搞Python环境,居然一次成功了,感动
评论头像
长歌吟松风 2026年01月28日
pdm用户表示很欣慰,终于不用每次切源了
评论头像
黄昏车站 2026年01月29日
simple路径真的容易漏,我上次就卡这儿了
评论头像
风语旅人 2026年01月30日
配置完跑了个大包,速度从50KB/s提到8MB/s,离谱
评论头像
废土暗影 2026年02月02日
homebrew也能这么配?学到了(不是)
评论头像
巨蟹暖阳 2026年02月03日
国内开发真离不开镜像源,原生源根本连不上
评论头像
番茄酱酱 2026年02月06日
要是能自动测速选最快源就好了,手动太麻烦

发表评论