Python国内镜像源配置全攻略（2025最新版）

最新推荐文章于 2025-05-12 15:21:13 发布

安装虚拟机的老师傅

最新推荐文章于 2025-05-12 15:21:13 发布

阅读量2.1k

点赞数 4

文章标签： python 开发语言其他

本文链接：https://blog.csdn.net/xiaowangabc1/article/details/147308339

版权

文章目录

大家好！今天要跟你们分享一个Python安装过程中99%新手都会忽略的重要环节——国内镜像源的配置！（超级重要）遇到过pip install卡成狗的情况吗？下载个requests库都要等半小时？别慌！看完这篇你就知道怎么让下载速度飞起来～

🌟为什么要用镜像源？

先来个灵魂拷问：为什么官方源这么慢？（抓狂）因为Python的官方仓库pypi.org服务器在国外！国内访问就像骑自行车上高速——根本跑不动！这时候就需要国内镜像源来拯救你的网速啦～

国内主流镜像源推荐：

清华大学镜像源（最稳定）
阿里云镜像源（速度最快）
豆瓣源（老牌稳定）
腾讯云镜像源（新晋选手）

💻Windows系统配置教程

方法1：临时使用（适合偶尔使用）

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

举个栗子🌰：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy

方法2：永久配置（推荐！）

按下Win+R打开运行窗口
输入%APPDATA%回车
新建pip文件夹（如果不存在的话）
在pip文件夹里新建pip.ini文件
用记事本打开输入以下内容：

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

（注意！！！文件后缀一定要是.ini不是.txt）

🍎MacOS/Linux配置方法

临时使用：

pip install -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com 包名

永久配置：

打开终端
创建配置文件：

mkdir ~/.pip
nano ~/.pip/pip.conf

输入以下内容：

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

按Ctrl+O保存，Ctrl+X退出

🚀加速效果对比

用清华大学源下载numpy：

Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/.../numpy-1.24.3-cp39-cp39-win_amd64.whl (14.8 MB)
---------------------------------------- 14.8/14.8 MB 8.2 MB/s eta 0:00:00

看到没！8.2MB/s的下载速度，比原来的50KB/s快了160倍！（泪目）

🔧常见问题排雷

Q：配置后出现SSL错误怎么办？
A：把https改成http试试，或者在配置里加上trusted-host

Q：镜像源突然不可用了？
A：建议收藏这几个备用镜像地址：

腾讯云：http://mirrors.cloud.tencent.com/pypi/simple
华为云：https://repo.huaweicloud.com/repository/pypi/simple

Q：想换回官方源怎么办？
A：直接删除配置文件就行，或者把index-url改成https://pypi.org/simple

💡高级技巧

给conda用户的小贴士：

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --set show_channel_urls yes

多源自动切换方案（适合老司机）：

[global]
index-url = 
    http://pypi.douban.com/simple/
    https://mirrors.aliyun.com/pypi/simple/
    https://pypi.tuna.tsinghua.edu.cn/simple

🎯终极验证方法

输入这个命令看看配置是否生效：

pip config list

看到类似这样的输出就成功啦：

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

最后提醒一句：不同镜像源的同步时间可能不同，如果遇到找不到最新包的情况，可以临时切换其他镜像源试试。建议大家把清华源和阿里源都保存到浏览器书签，需要的时候随时切换！

（下次想学Python虚拟环境管理的扣1，想看Jupyter Notebook配置技巧的扣2～）