pip 镜像源及其设置方法

ChaliceJoker

已于 2025-07-02 14:03:16 修改

阅读量351

点赞数 14

CC 4.0 BY-SA版权

文章标签： pip

于 2025-07-02 11:49:01 首次发布

本文链接：https://blog.csdn.net/qq_53018334/article/details/149066280

🌐 常用国内镜像源清单（推荐使用）

镜像名称	URL	稳定性	更新频率
清华镜像站	https://pypi.tuna.tsinghua.edu.cn/simple	⭐⭐⭐⭐⭐	非常高
阿里云镜像	https://mirrors.aliyun.com/pypi/simple	⭐⭐⭐⭐⭐	高
中科大镜像	https://pypi.mirrors.ustc.edu.cn/simple	⭐⭐⭐⭐	高
豆瓣镜像	https://pypi.doubanio.com/simple	⭐⭐⭐⭐	较高
华为云镜像	https://repo.huaweicloud.com/repository/pypi/simple	⭐⭐⭐⭐	高
腾讯云镜像	https://mirrors.cloud.tencent.com/pypi/simple	⭐⭐⭐	中等

推荐首选：清华镜像站或阿里云镜像，更新速度快且稳定性好

快速使用方法

pip install <包名称> -i <镜像URL>

🛠 设置默认镜像源方法

方法一：临时使用镜像源（单次安装）

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

方法二：命令行永久配置（用户级）

Windows (CMD/PowerShell):

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn

macOS/Linux:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

🔍 验证配置是否生效

# 查看当前配置
pip config list

# 安装测试包验证速度
pip install -U pip --verbose

不同系统下的最佳实践

Windows: 建议使用配置文件方式，避免权限问题
macOS/Linux: 可结合环境变量和全局配置

🔁 恢复默认镜像源

# 方法一：删除配置文件
rm ~/.pip/pip.conf  # macOS/Linux
del %APPDATA%\pip\pip.ini  # Windows

# 方法二：命令行重置
pip config unset global.index-url
pip config unset global.trusted-host