Windows环境下配置pip镜像源

在 Windows 环境下配置 pip 镜像源,核心就是创建一个(或修改)配置文件,告诉 pip 以后从国内镜像下载。这能从根本上解决下载慢、超时的问题。

这里有几种方法,你可以根据自己的情况选择。最推荐的是方法一,一劳永逸。

第一步:找到配置文件的"家"

pip 的配置文件在 Windows 里是一个叫 pip.ini 的文件,通常放在 %APPDATA%\pip\ 目录下。

  • %APPDATA% 是一个系统环境变量,代表当前用户的应用程序数据存放目录,通常类似 C:\Users\你的用户名\AppData\Roaming

第二步:创建并编辑配置文件

你可以通过以下两种方式之一来操作,效果是一样的。

  • 方法一:手动创建(最稳妥,推荐)

    1. 快速进入目录 :按下键盘上的 Win + R 键,打开"运行"对话框,输入 %APPDATA% 并回车。

    2. 新建 pip 文件夹 :在打开的 Roaming 文件夹中,检查有没有一个名为 pip 的文件夹。如果没有,就右键新建一个,并命名为 pip

    3. 新建 pip.ini 文件 :进入这个 pip 文件夹,在里面新建一个文本文件(右键 -> 新建 -> 文本文档),然后将这个文件重命名pip.ini。系统会提示你确认更改文件扩展名,点击"是"。

    4. 编辑文件 :用记事本打开这个 pip.ini 文件,将下面的内容复制粘贴进去,然后保存:

      ini 复制代码
      [global]
      index-url = https://pypi.tuna.tsinghua.edu.cn/simple
      [install]
      trusted-host = pypi.tuna.tsinghua.edu.cn

      这里用的是清华大学的镜像源,是目前比较稳定和快速的之一。你也可以根据需要换成其他源,比如阿里云 (https://mirrors.aliyun.com/pypi/simple/) 或豆瓣 (https://pypi.douban.com/simple/)。加上 trusted-host 是为了让 pip 信任这个源,避免可能的HTTPS错误。

  • 方法二:使用命令自动设置(更快捷)

    如果你觉得手动找文件比较麻烦,可以用 pip 自带的命令来配置。打开命令提示符 (cmd) 或 PowerShell,直接输入以下命令并回车:

    bash 复制代码
    pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

    这个命令会自动帮你创建好配置文件并写入内容,非常方便。

✅ 第三步:验证一下,确保生效

配置好之后,可以验证一下是否成功。在命令行中输入:

bash 复制代码
pip config list

如果看到输出中包含了 global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple' 这样的信息,就说明配置成功了!

💡 额外的小建议

  • 安装时临时换源 :如果只是偶尔想用另一个源,不需要修改配置文件,可以直接在安装命令后面加上 -i 参数。例如:pip install numpy -i https://mirrors.aliyun.com/pypi/simple/
  • 常用国内镜像源汇总:为了方便你选择,这里整理了几个常用的国内镜像源地址:
镜像源名称 镜像源地址
清华大学 https://pypi.tuna.tsinghua.edu.cn/simple
阿里云 https://mirrors.aliyun.com/pypi/simple/
豆瓣 https://pypi.douban.com/simple/
中国科学技术大学 https://pypi.mirrors.ustc.edu.cn/simple/

按照上面的步骤操作,以后再安装Python包时,速度应该会有明显的提升。

相关推荐
jyOverQ11 小时前
ChatGPT Windows 客户端点击无反应、有进程却没窗口?一次 MSIX 非系统盘启动卡死的完整排查
windows·chatgpt
还是大剑师兰特14 小时前
MySQL8.0 Windows完整安装教程
windows·mysql·大剑师
redfred16 小时前
HandBrake 使用教程:开源视频压缩工具 视频太大压缩 MKV转MP4 批量转码 硬件加速 Windows/macOS/Linux
windows·开源·音视频
kakakahahahaha16 小时前
【Windows】C盘拒绝访问0x80070005的7步排查
windows·电脑·内容运营·软件需求
万年咸鱼19 小时前
Java ArrayList 详解:原理、用法与实战
java·开发语言·windows
奈斯先生Vector19 小时前
本地图片识别怎么接入多模态 AI?用 Python API 理解 GPT-4o Vision 的真实工作流
开发语言·人工智能·windows·python·网络协议·http·aigc
yyywxk20 小时前
ChatGPT/Codex Windows 桌面版“幽灵会话”问题:网页端已删除,桌面端仍显示且无法删除/归档
windows·chatgpt
万年咸鱼20 小时前
Java List 接口详解:从基础到实战
java·windows·list
Neighbor_OldY21 小时前
【实战复盘】RDP暴力破解与内网横向移动溯源:Windows全套排查命令与事件ID硬核解析
运维·windows·web安全
深念Y21 小时前
Windows 11 工具链部署与 SSH 踩坑笔记
windows·笔记·ssh