推荐用 pip config set 命令永久配置中科大源:pip config set global.index-url https://pypi.mirrors.ustc.edu.cn/simple/ 和 trusted-host;临时安装则用 -i 参数加 --trusted-host;手动配置为备用方案。

直接用 pip config set 命令配,比手动改文件快、少出错,也兼容新旧 pip 版本。
临时安装时指定中科大源
只装一次包、不想改配置,就加 -i 参数:
pip install requests -i https://pypi.mirrors.ustc.edu.cn/simple/- 如果报
CertificateError或提示证书不可信,补上--trusted-host pypi.mirrors.ustc.edu.cn - 注意 URL 末尾必须是
/simple/,少斜杠会 404 - 这个方式不改变任何配置,适合 CI 脚本或临时调试
用 pip config 命令永久设置
推荐首选方式,自动写入用户级配置,无需关心路径和文件名:
生成 GitHub Actions、GitLab CI、Jenkins 的 CI/CD 流水线配置,适用于 Node.js、Python、Go、Docker 项目,支持回滚等配置。
- 执行:
pip config set global.index-url https://pypi.mirrors.ustc.edu.cn/simple/ - 再执行:
pip config set global.trusted-host pypi.mirrors.ustc.edu.cn - 验证是否生效:
pip config list,输出里应含这两行 - 如果提示
ERROR: No such configuration key,说明 pip 太老,先升级:pip install --upgrade pip
手动创建配置文件(备用方案)
当 pip config 不可用(比如某些嵌入式环境或旧系统),才用这个:
- Windows:在
%USERPROFILE%\pip\pip.ini中写入:
[global] index-url = https://pypi.mirrors.ustc.edu.cn/simple/ trusted-host = pypi.mirrors.ustc.edu.cn
- macOS/Linux:在
~/.pip/pip.conf中写入相同内容 - 注意:目录和文件名大小写敏感,
.pip是隐藏目录,pip.conf不能叫pip.config或pip.txt - 如果已有
pip.conf,别覆盖,只追加或修改[global]段落
中科大源响应快但同步延迟略高,大型包(如 pytorch)偶尔会比清华/阿里源慢几小时,遇到安装失败可临时切回清华源试一下。

















