pip 使用清华源

pip 使用清华源的详细教程

1. 临时使用清华源

清华源地址

https://pypi.tuna.tsinghua.edu.cn/simple

在安装包时直接指定镜像源（以 numpy 为例）：

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

2. 永久配置清华源

方法一：直接修改 pip 配置文件

1. 创建或修改 pip 配置文件

   • Windows：
     在文件资源管理器地址栏输入 %APPDATA% 回车，进入目录后创建 pip 文件夹，然后在其中创建 pip.ini 文件。
     或直接运行命令：

     mkdir "%APPDATA%\pip" && notepad "%APPDATA%\pip\pip.ini"
     

   • macOS/Linux：
     在终端执行以下命令创建配置文件：

     mkdir -p ~/.pip && nano ~/.pip/pip.conf
     

2. 写入以下内容：

   [global]
   index-url = https://pypi.tuna.tsinghua.edu.cn/simple
   trusted-host = pypi.tuna.tsinghua.edu.cn
   

3. 保存文件

   • Windows：保存 pip.ini 后关闭记事本。
   • macOS/Linux：按 Ctrl+O 保存，Ctrl+X 退出 nano。

方法二：通过命令行配置

直接运行以下命令自动配置：

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

3. 验证配置是否生效

运行以下命令查看当前 pip 源：

pip config list

若输出包含 index-url = https://pypi.tuna.tsinghua.edu.cn/simple 则配置成功。

4. 其他注意事项

1. 升级 pip 自身：
   使用清华源升级 pip：

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

2. 恢复默认源：
   删除配置文件或运行：

   pip config unset global.index-url
   

3. HTTPS 证书问题：
   若遇到证书错误，添加 trusted-host 参数（已在上述配置中包含）。

为什么选择清华源？

• 速度快：国内服务器加速下载。
• 稳定性高：同步官方 PyPI 频率高（每 5 分钟一次）。

如有问题，可访问清华源官网查看更新：清华 PyPI 镜像帮助