Python 镜像源列表
常用国内镜像源
-
清华大学(推荐)
https://pypi.tuna.tsinghua.edu.cn/simple -
阿里云
https://mirrors.aliyun.com/pypi/simple -
中国科学技术大学
https://pypi.mirrors.ustc.edu.cn/simple -
豆瓣
https://pypi.douban.com/simple -
华为云
https://mirrors.huaweicloud.com/repository/pypi/simple -
腾讯云
https://mirrors.cloud.tencent.com/pypi/simple
国外镜像源
-
官方源(默认)
https://pypi.org/simple -
微软
https://pypi.microsoft.com/simple
需要使用镜像源的情况
1. 网络访问问题
- 在中国大陆访问国外源速度慢或无法访问
- 企业内网限制访问境外网站
- 网络连接不稳定
2. 提高下载速度
- 批量安装大量包时
- CI/CD 流水线中需要快速安装依赖
- 开发团队共享相同的依赖源
3. 特定环境需求
- 离线环境:搭建本地私有镜像源
- 安全要求:企业内网不允许访问外网
- 稳定性:避免官方源宕机影响开发
4. 版本控制
- 固定依赖版本,避免因官方源更新导致版本变化
- 保证不同环境安装的一致性
使用方法
临时使用
# 安装单个包时指定镜像源
pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple
# 或使用 --index-url
pip install --index-url https://pypi.tuna.tsinghua.edu.cn/simple package_name
永久配置
Linux/macOS
# 创建配置文件
mkdir -p ~/.pip
cat > ~/.pip/pip.conf << EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
timeout = 120
EOF
Windows
# 在用户目录创建 pip.ini
# C:\Users\<用户名>\pip\pip.ini
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
timeout = 120
使用代理(备选方案)
如果镜像源仍然有问题,可以使用代理:
pip install --proxy http://proxy-server:port package_name
注意事项
- 镜像同步延迟:镜像源可能比官方源延迟几小时到一天
- HTTPS 证书:如果使用 HTTPS 遇到问题,可以尝试:
- 添加
--trusted-host参数 - 或使用 HTTP 协议(不推荐)
- 添加
- 依赖完整性:确保镜像源包含所有需要的包
- 企业环境:建议搭建私有镜像源(使用 devpi 或 bandersnatch)
选择哪个镜像源主要取决于你的地理位置和网络环境,国内用户通常使用清华或阿里云的镜像源体验最佳。