PyCharm和VS Code中怎么设置Python国内镜像源

在新建 Python 项目准备安装 requests、numpy 或 pandas 时，运行 pip install 经常会遇到下载进度条停滞、速度只有几 KB/s 甚至直接抛出 Read timed out 错误的情况。出现该现象的核心原因在于，Python 官方默认使用的包仓库服务器部署在海外，国内网络发起直连请求时往往延迟高、丢包严重。将源地址切换到清华大学、阿里云或腾讯云等国内同步镜像站，即可大幅提高下载速率并保证环境配置的稳定性。PyCharm 和 VS Code 针对这一需求各有适用的设置路径，本文将分步演示两款工具的具体配置流程、全局生效方案与验证手段。

图 1：Python 默认海外源与国内镜像站请求链路差异

一、常用可靠的国内镜像源地址

国内有多家知名高校与大型科技企业维护着公开的 PyPI 镜像站，通常每隔数分钟至数小时与官方 PyPI 完成一次双向索引比对。配置时必须注意使用完整的 /simple 路径，否则包管理工具无法正确解析索引规范：

二、在 PyCharm 中设置国内镜像源

PyCharm 提供了专用的图形化解释器管理面板，同时也配备了项目内部终端。设置国内源有两种途径：图形界面修改和内置终端配置。

方法 1：通过图形界面为项目解释器添加镜像源

该方法适合习惯点击界面的读者，配置后可直接在 PyCharm 的软件包检索列表中搜索并安装第三方库：

1. 打开 PyCharm，在顶部菜单栏依次点击：
   • Windows / Linux：File（文件） > Settings（设置）
   • macOS：PyCharm > Settings 或 Preferences（偏好设置）
2. 在左侧列表中找到并展开 Project: <你的项目名>，点击 Python Interpreter（Python 解释器）。
3. 在右侧列表中可以看到当前已安装的库。点击列表上方的 “+” 按钮（较新版本为直接点击左上角 Package 搜索栏或 Manage Repositories 按钮）。
4. 在弹出的 Available Packages（可用包）窗口底部，点击 Manage Repositories（管理仓库）按钮。
5. 在弹出的仓库管理列表中，点击右侧的 “+” 图标，输入国内镜像地址，例如：
   https://pypi.tuna.tsinghua.edu.cn/simple
6. 选中国内源条目，可删除默认的 https://pypi.org/simple，或者将其移至首位，最后依次点击 OK 保存并关闭所有窗口。

图 2：PyCharm 图形界面配置 Manage Repositories 流程分解

方法 2：在 PyCharm 内置终端中一键写入全局配置（推荐）

部分读者反馈在图形界面添加了镜像源，但在 PyCharm 底部 Terminal（终端）运行 pip install 依然连接官方慢速源。这是因为图形界面的仓库管理主要服务于 IDE 自带的 GUI 安装器，而内置终端执行的是系统或虚拟环境的 pip 命令。要让终端也享受加速，最彻底的做法是在 PyCharm 的 Terminal 窗口中运行全局命令：

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

如果所在网络环境对 SSL 证书有特殊校验要求，或者为了防止某些网络设备拦截，可同时将该域名加入受信任主机：

pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn

三、在 VS Code 中设置 Python 国内镜像源

VS Code 作为一个高扩展性的轻量级代码编辑器，其 Python 开发支持依赖于官方提供的 Python 插件。与 PyCharm 不同，VS Code 本身不内置类似“仓库管理器”的独立弹窗，它的包安装完全通过命令行终端交由底层的 pip 工具执行。因此，在 VS Code 中设置镜像源，本质上是配置当前 Python 环境所引用的 pip 配置文件。

图 3：VS Code 集成终端中 pip 配置文件的读取与存储链路

方式 1：在 VS Code 集成终端中执行命令设置（最为推荐）

该方法最为省心，能够跨平台自动识别用户目录并创建规范的配置文件：

1. 在 VS Code 中打开任意项目文件夹。
2. 按快捷键 Ctrl + `（反引号，位于 Esc 键下方；macOS 对应 Cmd + `），或者点击顶部菜单 Terminal > New Terminal（终端 > 新建终端）。
3. 在终端光标处直接粘贴并运行以下配置命令：

   pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

4. 继续运行补充信任命令（针对特定企业网络防拦截）：

   pip config set install.trusted-host mirrors.aliyun.com

5. 运行完成后，后续在 VS Code 任何终端中执行 pip install 都会自动走阿里镜像源。

方式 2：手动创建或修改 pip 配置文件

如果由于权限限制无法执行 pip config，可以直接手动在指定路径新建配置文件：

• Windows 系统：按下 Win + R 键，输入 %APPDATA% 回车。在打开的文件夹中查看是否存在 pip 文件夹；若无则新建一个，随后在 pip 文件夹内新建文本文档并重命名为 pip.ini（注意确保文件后缀为 .ini 而不是 .ini.txt）。
• macOS / Linux 系统：在终端中执行 mkdir -p ~/.pip && touch ~/.pip/pip.conf。

使用 VS Code 打开该文件，填入以下标准配置内容并保存：

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

[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

方式 3：单次安装临时指定源（免配置）

如果只是偶尔临时安装某个特定包，不想改变开发环境的全局默认行为，可以在执行 pip install 时追加 -i 参数：

pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple

四、配置生效验证与常见问题排查

完成上述配置后，需要通过针对性的命令核实源地址是否真正生效，以及在遇到异常时如何快速处置。

1. 验证配置是否生效

在 PyCharm 或 VS Code 的终端中执行：

pip config list

若屏幕输出如下内容，说明全局配置已经正确写入：

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

随后可尝试安装一个轻量包进行测速验证：

pip install wheel -vvv

在控制台输出的日志中，观察 Looking in indexes: ... 后面的地址是否为配置好的清华源或阿里源，并确认下载过程是否在瞬时完成。

2. 常见问题排查

图 4：设置方式选型决策与三步验证流程

五、总结

设置 Python 国内镜像源是解决包安装缓慢与超时的核心手段。总结两款编辑器的操作关键：

• PyCharm：可通过 Settings > Project Interpreter > Manage Repositories 统一修改图形界面的包搜索源，但在终端执行时依然依赖 pip 配置文件，因此推荐在 PyCharm 底部终端内执行一次 pip config set global.index-url ... 保证双轨生效。
• VS Code：包管理直接依赖命令行终端，通过终端运行 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple 是最稳妥直接的方法，既不需要手动创建隐藏文件，也能自动兼顾跨平台配置。

无论采用哪种方法，配置完成后运行 pip config list 验证输出，并在遇到 SSL 握手报错时补齐 trusted-host，即可确保在今后的 Python 开发中始终获得高速、稳定的依赖包下载体验。