【已解决】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的配置文件，将默认源更换为国内镜像源，可以完美解决此问题。
具体步骤
打开uv配置目录
- 在Windows资源管理器中输入：
%APPDATA%\uv - 按回车键进入该目录
- 在Windows资源管理器中输入：
创建配置文件
- 在该目录下新建一个文本文件
- 将文件命名为：
uv.toml
编辑配置文件
用文本编辑器打开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，不要同时启用两个源
保存并重启
- 保存
uv.toml文件 - 完全关闭PyCharm
- 重新启动PyCharm
- 保存
重新创建项目
- 再次尝试创建新项目
- 选择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"注意事项
- 文件位置：确保
uv.toml文件放在正确的目录下（%APPDATA%\uv） - 文件格式：TOML文件对格式敏感，确保使用正确的语法
- 重启生效：修改配置后一定要重启PyCharm
- 源选择：如果某个源不稳定，可以尝试切换到另一个国内镜像源
- 网络环境：在某些严格的网络环境下，可能需要额外的网络配置
验证配置是否生效
创建项目成功后，可以通过以下方式验证：
查看uv的配置信息：
uv config list检查Python包下载速度：
uv pipinstallrequests
总结
通过简单的配置文件修改，将uv的默认源更换为国内镜像源，可以有效解决PyCharm中因网络问题导致的项目创建失败。这个方法不仅适用于PyCharm，也适用于任何使用uv管理Python环境的场景。
国内常用镜像源对比：
- 阿里云：速度快，稳定性好
- 清华源：更新及时，覆盖面广
- 华为云：新兴源，速度也不错
选择哪个源主要取决于你的地理位置和网络状况，可以都尝试一下，选择最适合自己的。
希望这篇记录能帮助到遇到同样问题的开发者！