配置 pip 使用国内镜像源加速 Python 包安装

概述

为解决 Python 包安装时因网络延迟导致的下载速度问题，可通过配置 pip 使用国内镜像源（如阿里云、清华大学 TUNA 镜像站）替代默认的 PyPI 源。本文提供临时使用、全局配置及 Linux 系统级配置的具体方法。

镜像源地址

• 阿里云：https://mirrors.aliyun.com/pypi/simple/
• 清华大学 TUNA：https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

使用方法

1. 临时指定镜像源

在安装命令中通过 -i 参数临时指定镜像地址：

pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple some-package

2. 设置全局默认镜像

通过 pip config 命令配置默认源：

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

3. 手动修改配置文件

Linux 系统需编辑 ~/.pip/pip.conf 文件（若不存在则新建），添加以下内容：

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host = mirrors.aliyun.com

注意事项

• 信任主机：若使用自签名证书的镜像源，需通过 trusted-host 参数避免 SSL 验证错误。
• 系统差异：Windows 用户配置文件路径为 %APPDATA%\pip\pip.ini，操作逻辑与 Linux 类似。
• 镜像切换：可交替使用阿里云或 TUNA 镜像，根据网络环境选择最优选项。

总结

配置 pip 国内镜像源可显著提升 Python 包安装效率，建议根据实际需求选择临时或全局配置方式。若需进一步管理多版本 Python 环境，可结合 pyenv 或 update-alternatives 工具。