一文教你解决 pip 下载太慢了的问题 || 下载时因为网络不好中断下载的问题

一、找到 pip 配置文件路径

1.配置文件位置：

        Windows 系统的 pip 配置文件默认不存在，需要手动创建，路径为：

C:\Users\你的用户名\pip\pip.ini

• 用户目录：通常是 C:\Users\Administrator 或 C:\Users\你的电脑用户名。
• pip 文件夹：如果不存在，需要手动创建。

 

二、创建或编辑 pip.ini 文件

1. 手动创建步骤

   • 在资源管理器中进入 C:\Users\你的用户名。
   • 新建文件夹 pip（如果不存在）。
   • 进入 pip 文件夹，新建文本文件并命名为 pip.ini。

2. 写入配置内容
   用记事本或 notepad++、Trpora 打开 pip.ini，添加以下内容（以清华源为例）：

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

[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
disable-pip-version-check = true
timeout = 120

• 上述说明：

  1. index-url：指定镜像源地址。
  2. trusted-host：允许从该主机下载包（避免 SSL 警告）。
  3. disable-pip-version-check：关闭 pip 版本检查，加快安装速度。
  4. timeout：设置超时时间（秒），避免网络波动导致安装中断。

 

三、注意事项

1. 文件编码

   • 保存 pip.ini 时，确保编码为 UTF-8，避免中文乱码。
   • 推荐使用 VS Code 等编辑器保存，避免记事本默认使用 ANSI 编码。

2. 路径正确性

   • 确保文件路径为 C:\Users\你的用户名\pip\pip.ini，大小写不敏感。

3. 多镜像源配置（可选）
     若需要使用多个镜像源（按优先级 fallback），可添加 extra-index-url：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
extra-index-url = 
    https://mirrors.aliyun.com/pypi/simple/
    https://pypi.doubanio.com/simple/

四、验证配置是否生效

1. 查看当前配置
   打开命令提示符，执行：

pip config list

         输出应显示：

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

       2.测试下载速度

        安装一个小包测试（如 requests）：

pip install requests

         观察下载链接是否包含镜像源域名（如 tuna.tsinghua.edu.cn）。

五、以下为一些其他常见问题

        1.配置不生效？

         检查文件路径是否正确，文件名是否为 pip.ini（而非 pip.ini.txt）。

         尝试删除配置文件后，使用命令行重新配置：

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

        2.恢复默认源

         删除 pip.ini 文件，或执行：

pip config unset global.index-url
pip config unset install.trusted-host

        3.虚拟环境配置

         虚拟环境会继承全局配置，但也可单独设置：

# 激活虚拟环境后执行
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

推荐镜像源列表：

镜像源	URL 地址
清华大学	Simple Index
阿里云	Simple Index
中国科技大学	Verifying - USTC Mirrors
豆瓣	Simple Index

通过以上步骤，可以永久更改 Windows 系统的 pip 源，大幅提升 Python 包的下载速度。配置完成后，后续使用 pip 无需再手动指定镜像源。