Python pip 换源操作指南

pip 换源操作指南

原文链接

在中国使用 pip 安装 Python 包时，由于网络原因，默认的 PyPI 源速度较慢甚至可能无法访问。为了提高安装速度和成功率，我们可以将默认的 PyPI 源替换为国内的镜像源。以下是一些常用的国内源及具体的换源方法。

常用国内源

以下是一些常用的国内镜像源，这些镜像源通常速度较快且稳定：

• 阿里云: https://mirrors.aliyun.com/pypi/simple/
• 清华大学: https://pypi.tuna.tsinghua.edu.cn/simple/
• 中国科学技术大学: https://pypi.mirrors.ustc.edu.cn/simple/
• 豆瓣: https://pypi.doubanio.com/simple/

临时换源

临时换源是指在安装某个包时，通过命令行参数指定镜像源。这种方法适用于单次或少量包的安装。操作示例如下：

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

在上述命令中，-i 参数后跟的是指定的镜像源 URL。这个命令告诉 pip 在安装 numpy 包时使用清华大学的镜像源。

永久换源

如果你经常需要安装 Python 包，可以通过修改 pip 的配置文件来永久更改镜像源。这种方法更为便捷，因为不需要每次安装包时都指定镜像源。以下是针对不同操作系统的永久换源设置方法：

1. Linux/macOS: 修改或创建 ~/.pip/pip.conf 文件：

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

2. Windows: 修改或创建 %HOMEPATH%\pip\pip.ini 文件：

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

上述配置将 pip 的默认源设置为清华大学的镜像源。你可以根据需要更换为其他国内源。

其他配置选项

除了 index-url，pip 配置文件还支持许多其他配置选项。以下是一些常见的配置选项及其用途：

• trusted-host: 用于指定信任的主机名，避免 SSL 证书验证错误。

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

• timeout: 设置网络请求的超时时间（单位：秒），防止网络不佳时请求挂起。

  [global]
  timeout = 30
  

• retries: 设置请求失败后的重试次数，提高在网络不稳定时的安装成功率。

  [global]
  retries = 5
  

使用 pip 的最佳实践

1. 虚拟环境: 在项目中使用虚拟环境（如 venv 或 virtualenv），隔离项目的依赖包，避免不同项目之间的包冲突。

   python -m venv myenv
   source myenv/bin/activate  # Linux/macOS
   myenv\Scripts\activate     # Windows
   

2. requirements.txt: 在项目中使用 requirements.txt 文件记录依赖包及其版本，便于环境重建和依赖管理。

   pip freeze > requirements.txt  # 生成依赖文件
   pip install -r requirements.txt  # 从依赖文件安装包
   

3. 定期更新: 定期更新 pip 和依赖包，获取最新的功能和安全补丁。

   pip install --upgrade pip
   pip list --outdated  # 查看过时的包
   pip install --upgrade package_name  # 更新指定包
   

常见问题及解决方案

1. SSL 证书验证失败: 如果在使用某些镜像源时出现 SSL 证书验证错误，可以使用 trusted-host 参数信任该镜像源。

   pip install numpy -i https://pypi.doubanio.com/simple --trusted-host pypi.doubanio.com
   

2. 网络超时: 如果在安装包时遇到网络超时，可以增加 timeout 参数的值或重试安装。

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

通过以上方法和技巧，你可以更高效地使用 pip 管理 Python 包，提高开发效率和体验。