Python从入门到荒废-配置国内下载源

为提升 Python 包安装速度，配置国内下载源是常见需求。以下是主流方法汇总，结合稳定性和易用性推荐：

一、pip 永久配置国内源（推荐）

通过修改配置文件实现“一次配置，长期生效”：
创建/修改配置文件

Windows：

 路径：%APPDATA%\pip\pip.ini（如 C:\Users\用户名\AppData\Roaming\pip\pip.ini）  
 内容：  
      [global]
 index-url = https://pypi.tuna.tsinghua.edu.cn/simple
 trusted-host = pypi.tuna.tsinghua.edu.cn

Linux/macOS：

 路径：~/.pip/pip.conf  
 内容：  
      [global]
 index-url = https://pypi.tuna.tsinghua.edu.cn/simple
 trusted-host = pypi.tuna.tsinghua.edu.cn

验证配置生效

终端执行：
pip config list

若输出包含配置的镜像源地址，则生效。

⚡ 二、pip 临时使用国内源

安装命令中通过 -i 参数临时指定源（适合测试或安装特定包）：
pip install 包名 -i https://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com

三、conda 配置国内源

若使用 Anaconda/Miniconda，需同步配置 conda 源：
添加清华源（常用）

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/

设置搜索时显示通道地址

conda config --set show_channel_urls yes

⚠️ 注意：清华源不同步 pytorch-nightly 等极速更新包，需临时切官方源安装。

四、常用国内镜像源列表

根据速度和稳定性推荐（2025年实测有效）：
镜像名称 URL 特点

清华大学 https://pypi.tuna.tsinghua.edu.cn/simple 高校维护，覆盖全面，更新及时
阿里云 https://mirrors.aliyun.com/pypi/simple/ 企业级服务，稳定性高
腾讯云 https://mirrors.cloud.tencent.com/pypi/simple/ 低延迟，适合云环境
中国科技大学 https://pypi.mirrors.ustc.edu.cn/simple/ 教育网优化
华为云 https://mirrors.huaweicloud.com/repository/pypi/simple/ 企业级支持，安全性强

️ 五、虚拟环境专属配置

若使用 virtualenv 或 pipenv，可在虚拟环境中独立配置源：
pipenv 示例

pipenv install --pypi-mirror https://pypi.douban.com/simple

virtualenv 示例

source venv/bin/activate
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名

❓ 常见问题解决
SSL 证书错误：在配置中添加 trusted-host = 镜像域名（如 trusted-host = pypi.tuna.tsinghua.edu.cn）。

源同步延迟：临时切换其他镜像源或官方源（-i https://pypi.org/simple）。

速度仍慢：尝试 pip install --no-cache-dir 禁用缓存，或检查本地网络防火墙。

配置建议
首选 pip 永久配置 → 避免重复输入命令，推荐清华大学或阿里云源。

开发环境用虚拟环境独立配置 → 避免全局污染，适配不同项目需求。

定期验证源状态 → 执行 pip check 或访问镜像站主页（如清华源首页）确认服务状态。

实测清华源对 Python 3.7~3.12 兼容性最佳，若遇安装失败可尝试切换阿里云或华为云。