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 的配置文件来永久更改镜像源。这种方法更为便捷，因为不需要每次安装包时都指定镜像源。以下是针对不同操作系统的永久换源设置方法：
-
Linux/macOS: 修改或创建
~/.pip/pip.conf文件：[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple -
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 的最佳实践
-
虚拟环境: 在项目中使用虚拟环境（如
venv或virtualenv），隔离项目的依赖包，避免不同项目之间的包冲突。python -m venv myenv source myenv/bin/activate # Linux/macOS myenv\Scripts\activate # Windows -
requirements.txt: 在项目中使用
requirements.txt文件记录依赖包及其版本，便于环境重建和依赖管理。pip freeze > requirements.txt # 生成依赖文件 pip install -r requirements.txt # 从依赖文件安装包 -
定期更新: 定期更新 pip 和依赖包，获取最新的功能和安全补丁。
pip install --upgrade pip pip list --outdated # 查看过时的包 pip install --upgrade package_name # 更新指定包
常见问题及解决方案
-
SSL 证书验证失败: 如果在使用某些镜像源时出现 SSL 证书验证错误，可以使用
trusted-host参数信任该镜像源。pip install numpy -i https://pypi.doubanio.com/simple --trusted-host pypi.doubanio.com -
网络超时: 如果在安装包时遇到网络超时，可以增加
timeout参数的值或重试安装。pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple --timeout 60
通过以上方法和技巧，你可以更高效地使用 pip 管理 Python 包，提高开发效率和体验。
