【已解决】PyCharm中使用uv创建项目时Python安装失败的问题

问题背景

最近在使用PyCharm创建Python项目时遇到了一个问题：选择了Python版本后，环境设置总是失败。经过排查，发现是由于uv（一个快速Python包安装器）默认使用国外源，导致在国内网络环境下下载Python安装包失败。

问题表现

在PyCharm中创建新项目时：

• 选择使用uv作为包管理器
• 指定Python版本（如3.11、3.12等）
• 点击"创建"后，PyCharm提示环境设置失败
• 错误信息通常显示下载超时或连接失败

原因分析

uv默认配置使用的是PyPI官方源（https://pypi.org/simple/），该源位于国外。由于网络限制和连接速度问题，国内用户直接访问时经常会出现：

• 下载速度极慢
• 连接超时
• 无法完成Python安装包的下载

解决方案

通过修改uv的配置文件，将默认源更换为国内镜像源，可以完美解决此问题。

具体步骤

1. 打开uv配置目录

   • 在Windows资源管理器中输入：%APPDATA%\uv
   • 按回车键进入该目录

2. 创建配置文件

   • 在该目录下新建一个文本文件
   • 将文件命名为：uv.toml

3. 编辑配置文件
   用文本编辑器打开uv.toml文件，输入以下内容：

   # 使用阿里云镜像源 [[index]] url = "https://mirrors.aliyun.com/pypi/simple/" default = true # 或者使用清华源（二选一即可） # [[index]] # url = "https://pypi.tuna.tsinghua.edu.cn/simple/" # default = true

   注意：

   • 阿里云源和清华源都是国内常用的PyPI镜像，选择一个即可
   • 确保只设置一个default = true，不要同时启用两个源

4. 保存并重启

   • 保存uv.toml文件
   • 完全关闭PyCharm
   • 重新启动PyCharm

5. 重新创建项目

   • 再次尝试创建新项目
   • 选择Python版本
   • 此时能够正常下载并设置Python环境
     

其他可能的解决方案

方法二：通过命令行配置uv

如果你习惯使用命令行，也可以直接通过命令设置镜像源：

# 设置阿里云源uv configsetindex.url"https://mirrors.aliyun.com/pypi/simple/"# 或者设置清华源uv configsetindex.url"https://pypi.tuna.tsinghua.edu.cn/simple/"

方法三：临时使用环境变量

在创建项目时，可以临时设置环境变量：

# Windows PowerShell$env:UV_INDEX_URL="https://mirrors.aliyun.com/pypi/simple/"# 然后启动PyCharm

方法四：全局代理设置

如果你有稳定的代理服务，也可以考虑设置代理：

# 在uv.toml中添加代理配置 [proxy] http = "http://your-proxy:port" https = "http://your-proxy:port"

注意事项

1. 文件位置：确保uv.toml文件放在正确的目录下（%APPDATA%\uv）
2. 文件格式：TOML文件对格式敏感，确保使用正确的语法
3. 重启生效：修改配置后一定要重启PyCharm
4. 源选择：如果某个源不稳定，可以尝试切换到另一个国内镜像源
5. 网络环境：在某些严格的网络环境下，可能需要额外的网络配置

验证配置是否生效

创建项目成功后，可以通过以下方式验证：

1. 查看uv的配置信息：

   uv config list

2. 检查Python包下载速度：

   uv pipinstallrequests

总结

通过简单的配置文件修改，将uv的默认源更换为国内镜像源，可以有效解决PyCharm中因网络问题导致的项目创建失败。这个方法不仅适用于PyCharm，也适用于任何使用uv管理Python环境的场景。

国内常用镜像源对比：

• 阿里云：速度快，稳定性好
• 清华源：更新及时，覆盖面广
• 华为云：新兴源，速度也不错

选择哪个源主要取决于你的地理位置和网络状况，可以都尝试一下，选择最适合自己的。

希望这篇记录能帮助到遇到同样问题的开发者！