加速pip下载:永久解决网络慢问题

发布于:2025-05-11 ⋅ 阅读:(33) ⋅ 点赞:(0)

一文教你解决 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 无需再手动指定镜像源。


网站公告

今日签到

点亮在社区的每一天
去签到