当使用 uv 下载 Python 解释器时出现异常，通常是因为网络连接问题导致无法从 GitHub 下载安装包。以下是几种常见的解决方案：
- 配置 GitHub 镜像加速（推荐）
由于国内访问 GitHub 较慢或不稳定，可通过设置环境变量 UV_PYTHON_INSTALL_MIRROR 指向国内镜像源来解决。
Windows 系统：
右键"此电脑" → "属性" → "高级系统设置" → "环境变量"。
在"用户变量"或"系统变量"中点击"新建"。
变量名填写：uv_python_install_mirror
变量值填写（任选其一）：
https://gh-proxy.com/https://github.com/astral-sh/python-build-standalone/releases/download
https://ghfast.top/https://github.com/astral-sh/python-build-standalone/releases/download
点击"确定"保存，并重启终端或 PyCharm 使配置生效。
macOS / Linux 系统：
在终端中执行以下命令（以 zsh 为例）：
bash
Copy Code
echo 'export uv_python_install_mirror="https://gh-proxy.com/https://github.com/astral-sh/python-build-standalone/releases/download"' >> ~/.zshrc
source ~/.zshrc
若使用 bash，请将 ~/.zshrc 替换为 ~/.bashrc。
✅ 此方法专门解决 uv python install 命令下载 Python 解释器失败的问题。
1
2
- 配置 PyPI 镜像源（适用于包安装）
如果问题出现在安装 Python 包（而非安装 Python 解释器）时，可配置国内 PyPI 镜像源。
临时设置（仅当前会话有效）：
bash
Copy Code
export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"
Windows PowerShell 中：
powershell
Copy Code
$env:UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"
永久设置：
将上述 export 命令添加到 shell 配置文件（如 ~/.bashrc、~/.zshrc）中，或通过系统环境变量设置。
项目级配置（推荐用于团队协作）：
在项目根目录的 pyproject.toml 文件中添加：
toml
Copy Code
\[tool.uv.index\]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true
✅ 常用国内 PyPI 镜像源：
3
清华大学：https://pypi.tuna.tsinghua.edu.cn/simple
阿里云：https://mirrors.aliyun.com/pypi/simple/
豆瓣：https://pypi.douban.com/simple/
- 清理缓存并更新 uv
有时缓存损坏或版本过旧也会导致异常。
清理 uv 缓存：
bash
Copy Code
uv cache clean
检查并更新 uv 到最新版本：
bash
Copy Code
uv self update
- 检查网络与代理
确保网络连接正常，可尝试访问 https://github.com/astral-sh/python-build-standalone/releases 或 https://pypi.org/simple/。
若在公司网络或使用代理，需配置代理环境变量：
bash
Copy Code
export HTTP_PROXY=http://your-proxy-server:port
export HTTPS_PROXY=http://your-proxy-server:port
- 离线安装（适用于无网络环境）
若完全无法联网，可在有网络的机器上下载依赖后离线安装：
在联网机器上执行：
bash
Copy Code
uv pip download -d ./offline_packages -r requirements.txt
将 offline_packages 文件夹拷贝到目标机器。
在目标机器上执行：
bash
Copy Code
uv pip install --no-index --find-links ./offline_packages -r requirements.txt
📌 提示：若在 PyCharm 中创建项目时失败，建议先按方法 1 配置 GitHub 镜像，再重启 PyCharm 重新创建项目。
4