当使用 uv 下载 Python 解释器时出现异常,通常是因为网络连接问题导致无法从 GitHub 下载安装包

当使用 uv 下载 Python 解释器时出现异常,通常是因为网络连接问题导致无法从 GitHub 下载安装包。以下是几种常见的解决方案:

  1. 配置 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

  1. 配置 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/

  1. 清理缓存并更新 uv

有时缓存损坏或版本过旧也会导致异常。

清理 uv 缓存:

bash

Copy Code

uv cache clean

检查并更新 uv 到最新版本:

bash

Copy Code

uv self update

  1. 检查网络与代理

确保网络连接正常,可尝试访问 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

  1. 离线安装(适用于无网络环境)

若完全无法联网,可在有网络的机器上下载依赖后离线安装:

在联网机器上执行:

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

相关推荐
wuyk5551 小时前
Python办公自动化-第01讲-环境搭建与自动化认知
python·自动化·pyqt
高洁012 小时前
数字孪生与计算机视觉:让机器看懂现场
人工智能·python·机器学习·transformer·迁移学习
ComPDFKit2 小时前
RAG 回答只显示 PDF 文件名?用 Python 保留引用页码
开发语言·python·pdf·rag
yz_aiks3 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
2601_967980115 小时前
Flask Web 应用
python·flask·web开发·环境变量·虚拟环境
aifannihao6 小时前
ß 大写变 SS:用 Python 算清 Ruby2Shell 的缓冲区账本
python·安全·标准库·缓冲区溢出·字符串编码
liwulin05066 小时前
【OLLAMA】调用SKILL的通用ReAct
python
郝学胜-神的一滴7 小时前
Effective Python 条款36:优雅拼装迭代器与生成器
开发语言·数据结构·人工智能·python·numpy·scikit-learn
Norna8 小时前
Git 给路径加了引号,这个文件就从 review 里消失了
python
wuyk5558 小时前
Python办公自动化-第04讲-批量新建Excel
开发语言·python·excel