【已解决】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
- 按回车键进入该目录
创建配置文件
- 在该目录下新建一个文本文件
- 将文件命名为：uv.toml
编辑配置文件

用文本编辑器打开uv.toml文件，输入以下内容：
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

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

bash 复制代码

# 设置阿里云源
uv config set index.url "https://mirrors.aliyun.com/pypi/simple/"

# 或者设置清华源
uv config set index.url "https://pypi.tuna.tsinghua.edu.cn/simple/"

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

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

bash 复制代码

# Windows PowerShell
$env:UV_INDEX_URL="https://mirrors.aliyun.com/pypi/simple/"

# 然后启动PyCharm

方法四：全局代理设置

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

toml 复制代码

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

注意事项

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

验证配置是否生效

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

查看uv的配置信息：
bash 复制代码
```
uv config list
```
检查Python包下载速度：
bash 复制代码
```
uv pip install requests
```

总结

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

国内常用镜像源对比：

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

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

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