Python 国内pip install 安装缓慢

pip install 很慢？3秒解决！（Windows专用）

核心原因：默认是国外服务器 ，速度只有几十KB，换成国内镜像源，瞬间拉满网速！

最简单、最推荐的方法（直接复制运行）

打开 CMD / PowerShell ，直接粘贴这一整条命令回车：

bash 复制代码

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

✅ 速度直接提升 10~100倍，几秒钟就能装完！

永久提速（以后所有pip都飞快）

不想每次都加网址？运行这2行命令，一劳永逸：

bash 复制代码

# 新建配置文件夹
mkdir %USERPROFILE%\pip

# 写入国内镜像源
echo [global] >> %HOMEPATH%\pip\pip.ini
echo index-url = https://pypi.tuna.tsinghua.edu.cn/simple >> %HOMEPATH%\pip\pip.ini
echo trusted-host = pypi.tuna.tsinghua.edu.cn >> %HOMEPATH%\pip\pip.ini

设置完后，以后直接用 pip install 包名 就是满速下载！

备用镜像源（一个慢换另一个）

如果清华源还是慢，把后面的网址换成下面任意一个：

阿里云：https://mirrors.aliyun.com/pypi/simple/
豆瓣源：https://pypi.doubanio.com/simple/

使用示例：

bash 复制代码

pip install ultralytics -i https://mirrors.aliyun.com/pypi/simple/

想换回官方源？（也很简单）

运行这条命令删除配置文件即可：

cmd 复制代码

del %USERPROFILE%\pip\pip.ini

总结

临时极速安装：命令末尾加 -i 清华源网址
永久提速：运行我给的2行命令即可
装YOLOv8直接用：pip install ultralytics -i https://pypi.tuna.tsinghua.edu.cn/simple

国内镜像源的数据是怎么来的

国内 PyPI 镜像源（清华、阿里、豆瓣等）的数据，本质都是从官方 PyPI 源同步过来的 ，简单说就是：
官方有什么，它们就定期完整复制一份，存在国内服务器上。

下面用最通俗的话讲清楚：

1. 源头在哪里？

真正的"原版"只有一个：
https://pypi.org （Python Package Index）

所有开发者上传包（ultralytics、torch、numpy 等）都传到这里。

2. 国内镜像怎么来的？

国内镜像站（清华、中科大、阿里、豆瓣）会：

定期全量同步

每隔几小时/一天，自动从官方 PyPI 拉一遍：
- 所有包
- 所有版本
- 所有文件（.whl、.tar.gz）
存在国内高速服务器

放在电信/联通/移动机房，你下载时走国内线路，速度极快。
结构完全一样

只是域名和地址变了，文件内容完全一致，不会被修改。

3. 会不会不安全、被篡改？

官方 PyPI 上的包都有哈希校验
镜像只是存储转发，不改内容
清华、阿里这种大厂/高校镜像，可靠性很高

只要你用的是正规公开镜像，基本可以认为和官方源一样安全。

4. 为什么有时候镜像会慢/缺包？

刚发布的新版本，镜像还没同步到（延迟几十分钟～几小时）
某些超大包同步失败
镜像服务器临时维护

遇到这种情况，换回官方源或换一个镜像就行。

总结一句话

国内 PyPI 镜像 = 官方 PyPI 的定时完整拷贝，放在国内服务器给你加速下载。

Linux 下

一、Linux 永久设置清华源（复制运行）

打开终端，直接运行这 3 行命令：

bash 复制代码

# 1. 创建配置文件夹
mkdir -p ~/.config/pip

# 2. 写入清华镜像源
echo "[global]" > ~/.config/pip/pip.conf
echo "index-url = https://pypi.tuna.tsinghua.edu.cn/simple" >> ~/.config/pip/pip.conf
echo "trusted-host = pypi.tuna.tsinghua.edu.cn" >> ~/.config/pip/pip.conf

✅ 运行完就永久生效 ，以后所有 pip install 都满速！

二、Linux 临时加速（单次使用）

不想永久改，就直接在安装时加源：

bash 复制代码

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

三、Linux 换回官方源

bash 复制代码

rm ~/.config/pip/pip.conf

核心区别（一看就懂）

系统	配置路径
Windows	`%USERPROFILE%\pip\pip.ini`
Linux	~/.config/pip/pip.conf

Windows 用 .ini
Linux 用 .conf
文件夹名字也不一样
但功能完全一样，都是永久加速