【自记】PyCharm 更换阿里云国内源教程

前言

PyCharm 默认使用国外的 PyPI 源，在国内下载 Python 包时可能会遇到速度慢、卡顿甚至失败的问题。将源更换为国内阿里云镜像，可以显著提升下载速度和稳定性。本教程适用于 PyCharm 中文版，提供两种更换方法。

方法一：通过 PyCharm 界面设置（推荐）

步骤 1：打开 Python 解释器设置

1. 打开 PyCharm，进入顶部菜单栏的 文件 (F) → 设置 (S) （快捷键 Ctrl+Alt+S）
2. 在左侧导航栏中，依次展开 项目：你的项目名称 → 选择 Python 解释器
3. 点击右侧的 + 号按钮（添加包的按钮），打开 "可用软件包" 窗口

步骤 2：进入仓库管理界面

1. 在 "可用软件包" 窗口的右上角，点击 管理仓库 按钮（图标为齿轮 + 列表，中文版直接显示文字）
2. 此时会弹出 "仓库" 配置窗口

步骤 3：添加阿里云源并移除官方源

1. 在 "仓库" 窗口中，点击右侧的 + 号按钮

2. 在弹出的输入框中，粘贴阿里云源地址：

   https://mirrors.aliyun.com/pypi/simple/

3. 点击 "确定" 完成添加

4. 在仓库列表中，找到并选中官方源（https://pypi.org/simple/）

5. 点击右侧的 - 号按钮将其删除

6. 点击 "确定" 保存设置

步骤 4：验证设置

回到 "可用软件包" 窗口，在搜索框中输入任意包名（如 requests），点击搜索。如果能快速显示搜索结果，说明源更换成功。

方法二：通过配置文件设置（全局生效）

如果方法一中找不到 "管理仓库" 按钮，可以采用此方法，该方法对所有项目全局生效。

步骤 1：创建配置文件

1. 打开文件资源管理器，进入用户目录（通常路径为 C:\Users\你的用户名\）
2. 在该目录下，新建一个文件夹，命名为 .pip（注意文件夹名以英文句号开头）
3. 进入 .pip 文件夹，新建一个文本文件
4. 将文件命名为 pip.ini（确保文件扩展名为 .ini，而非 .txt。若看不到扩展名，可在 "查看" 菜单中勾选 "文件扩展名"）

步骤 2：配置阿里云源

1. 用记事本或其他文本编辑器打开 pip.ini 文件

2. 复制以下内容并保存：

   [global]
   index-url = https://mirrors.aliyun.com/pypi/simple/
   [install]
   trusted-host = mirrors.aliyun.com

步骤 3：生效配置

重启 PyCharm 使配置生效。之后无论是通过 PyCharm 界面安装包，还是使用 pip 命令安装，都会自动使用阿里云源。

验证配置是否成功

1. 打开 PyCharm 底部的 "终端"

2. 输入命令 pip config list 并回车

3. 如果输出中包含以下内容，说明配置成功：

   global.index-url='https://mirrors.aliyun.com/pypi/simple/'
   install.trusted-host='mirrors.aliyun.com'

总结

通过以上两种方法中的任意一种，都可以将 PyCharm 的软件源更换为阿里云国内源，从而解决下载 Python 包速度慢的问题。推荐优先使用方法一（界面设置），如需对所有项目生效，可选择方法二（配置文件）。