PyCharm配置pip国内镜像源加速库下载

当 pip 下载依赖包速度缓慢或出现连接超时时，可以在 PyCharm 中为项目配置可用的 PyPI 镜像源。在配置前，请确保项目已选中正确的 Python 解释器；需注意，仓库设置仅影响包搜索和安装时的索引来源，切换镜像不会更改项目解释器，也无法自动修复代理配置、证书错误或底层网络故障。

打开 Package Repositories

在 Windows 版 PyCharm 中，按下 Ctrl+Alt+S 打开 Settings 窗口，并在左侧导航栏进入 Python | Package Repositories。此外，也可以从 Python Packages 工具窗口的选项菜单中直接访问仓库设置。不同版本的界面布局可能略有差异；如果在左侧树状列表中未找到该项，可在 Settings 搜索框中输入 Package Repositories 进行定位。

该页面用于管理 PyCharm 查找 Python 包时可用的仓库列表。点击添加按钮以新增一行或打开添加对话框，并在仓库 URL 字段中填入镜像地址。请注意，不要将浏览器主页或镜像站的首页地址作为索引地址；pip 通常使用带有 /simple/ 路径的简单索引接口。

打开PyCharm的Python包仓库设置

添加清华镜像地址

例如，可以添加由清华 TUNA 提供的 PyPI 简单索引地址：

https://pypi.tuna.tsinghua.edu.cn/simple/

输入地址后确认保存，并检查新仓库是否已出现在列表中且处于启用状态。PyCharm 官方文档将此功能描述为添加自定义仓库的入口。若使用其他镜像站，请务必向该站维护方核对当前有效地址；由于镜像同步状态和可用性会随时间变化，请勿沿用来源不明的旧链接。

用项目解释器安装包

返回 Settings | Python | Interpreter 页面，确认顶部选中的解释器属于当前项目。随后打开 Python Packages 工具窗口，搜索所需包名并从结果中进行安装；也可以在解释器的包管理列表中使用安装按钮。如果使用的是 conda 环境，PyCharm 可能会提供 conda 包管理器选项，此时应确保仓库设置与实际使用的包管理器相匹配。

如果倾向于使用终端安装，可以在 PyCharm 的项目终端中运行常规 pip 命令并指定相同的镜像源，例如 python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ 包名。需要注意的是，这条命令仅对本次安装指定索引，其作用范围与在 PyCharm 设置中保存的持久化仓库地址不同。

在仓库地址栏添加镜像

检查选择与排查

添加镜像后，请仔细检查地址是否存在多余空格或拼写错误，并确保仓库已启用。在安装过程中，务必留意 PyCharm 当前选中的项目解释器：包将被安装到该解释器对应的环境中，因此更换项目或解释器后，不能仅凭 IDE 显示的包名来判断环境的一致性。

镜像能否提升下载速度取决于当前网络状况、镜像同步进度以及目标包的可用性。如果遇到找不到版本、连接失败或校验错误等问题，建议先临时切换回官方 PyPI 源进行对照测试，并仔细查看安装错误信息；切勿为了绕过错误而随意关闭 TLS 校验。若使用私有仓库或需要认证，应遵循组织提供的地址和凭据管理方式，严禁将密码写入公开文章或共享配置文件中。

确认镜像地址已列入仓库

为单个 PyCharm 项目设置镜像，适合希望通过图形界面便捷管理仓库的场景。如果需要在多个工具间统一配置，可以考虑使用 pip 的用户级配置文件；但在操作前需明确配置的作用范围，以避免项目级设置与全局设置相互覆盖。