前言

执行 pip install 时经常卡在下载、报超时或连接超时，原因是默认访问 PyPI 官方源，国内网络跨洋拉取慢。把 pip 源换成清华、阿里等国内镜像，下载速度立竿见影，还能避免频繁断连。本文讲解临时使用、永久配置、单个包指定源、还原官方源的完整命令，适配 Ubuntu22.04 与 Python3。

操作步骤

1. 查看当前 pip 源

pip3 config list

2. 临时使用清华源安装单个包

pip3 install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 永久配置清华源

mkdir -p ~/.config/pip
cat > ~/.config/pip/pip.conf <<'EOF'
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

4. 验证配置生效

pip3 config list
pip3 install requests

安装日志里出现 tuna 域名即成功。

5. 其他常用国内源

# 阿里
https://mirrors.aliyun.com/pypi/simple/
# 中科大
https://pypi.mirrors.ustc.edu.cn/simple/

6. 升级 pip 本身

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

7. 还原官方源

删除或注释 pip.conf 即可：

rm ~/.config/pip/pip.conf

常见坑

1. 只对 root 配置了源，普通用户 pip 仍走官方，需要各自配置或写到 /etc/pip.conf 全局。
2. 源地址漏写 /simple，报 404 或找不到包。
3. 用了 http 源被要求 trusted-host，否则报 SSL 警告。
4. 系统自带 python3-pip 和虚拟环境内 pip 配置互相独立。
5. 部分新包国内源同步有延迟，个别版本找不到可临时指定官方源。
6. 代理网络环境下镜像源仍需能直连，必要时配代理。
7. pip 与 pip3 混用，装到不同 Python 版本。

总结

换 pip 源最快是临时 -i 指定，长期使用写 pip.conf 的 index-url。优先清华、阿里镜像，地址必须带 /simple。配置后用 pip config list 核对，新包安装看日志确认走镜像。虚拟环境单独管理配置，避免装错版本。

遇到问题加QQ23979811 协助处理