【自记】PyCharm 更换阿里云国内源教程
前言
PyCharm 默认使用国外的 PyPI 源,在国内下载 Python 包时可能会遇到速度慢、卡顿甚至失败的问题。将源更换为国内阿里云镜像,可以显著提升下载速度和稳定性。本教程适用于 PyCharm 中文版,提供两种更换方法。
方法一:通过 PyCharm 界面设置(推荐)
步骤 1:打开 Python 解释器设置
- 打开 PyCharm,进入顶部菜单栏的 文件 (F) → 设置 (S)(快捷键
Ctrl+Alt+S
) - 在左侧导航栏中,依次展开 项目:你的项目名称 → 选择 Python 解释器
- 点击右侧的 + 号按钮(添加包的按钮),打开 "可用软件包" 窗口
步骤 2:进入仓库管理界面
- 在 "可用软件包" 窗口的右上角,点击 管理仓库 按钮(图标为齿轮 + 列表,中文版直接显示文字)
- 此时会弹出 "仓库" 配置窗口
步骤 3:添加阿里云源并移除官方源
- 在 "仓库" 窗口中,点击右侧的 + 号按钮
- 在弹出的输入框中,粘贴阿里云源地址:
https://mirrors.aliyun.com/pypi/simple/
- 点击 "确定" 完成添加
- 在仓库列表中,找到并选中官方源(
https://pypi.org/simple/
) - 点击右侧的 - 号按钮将其删除
- 点击 "确定" 保存设置
步骤 4:验证设置
回到 "可用软件包" 窗口,在搜索框中输入任意包名(如 requests
),点击搜索。如果能快速显示搜索结果,说明源更换成功。
方法二:通过配置文件设置(全局生效)
如果方法一中找不到 "管理仓库" 按钮,可以采用此方法,该方法对所有项目全局生效。
步骤 1:创建配置文件
- 打开文件资源管理器,进入用户目录(通常路径为
C:\Users\你的用户名\
) - 在该目录下,新建一个文件夹,命名为
.pip
(注意文件夹名以英文句号开头) - 进入
.pip
文件夹,新建一个文本文件 - 将文件命名为
pip.ini
(确保文件扩展名为.ini
,而非.txt
。若看不到扩展名,可在 "查看" 菜单中勾选 "文件扩展名")
步骤 2:配置阿里云源
- 用记事本或其他文本编辑器打开
pip.ini
文件 - 复制以下内容并保存:
[global] index-url = https://mirrors.aliyun.com/pypi/simple/ [install] trusted-host = mirrors.aliyun.com
步骤 3:生效配置
重启 PyCharm 使配置生效。之后无论是通过 PyCharm 界面安装包,还是使用 pip
命令安装,都会自动使用阿里云源。
验证配置是否成功
- 打开 PyCharm 底部的 "终端"
- 输入命令
pip config list
并回车 - 如果输出中包含以下内容,说明配置成功:
global.index-url='https://mirrors.aliyun.com/pypi/simple/' install.trusted-host='mirrors.aliyun.com'
总结
通过以上两种方法中的任意一种,都可以将 PyCharm 的软件源更换为阿里云国内源,从而解决下载 Python 包速度慢的问题。推荐优先使用方法一(界面设置),如需对所有项目生效,可选择方法二(配置文件)。