快捷導航

Python包管理工具uv下載python版本慢問題解決辦法

更新時間：2025年11月15日 09:53:19 作者：inrgihc

uv是一個非常快的Python包和項目管理器,用Rust編寫,使用熱緩存安裝Trio的依賴項的速度對比,這篇文章主要介紹了Python包管理工具uv下載python版本慢問題的解決辦法,需要的朋友可以參考下

發(fā)現(xiàn)問題

UV 是一個用 Rust 編寫的 Python 包安裝和依賴管理工具，當操作系統(tǒng)上已經(jīng)安裝了uv工具后，即可使用如下命令安裝指定版本的python：

uv python install 3.12

但是，默認情況下，uv會去github.com上下載指定版本的python，但咱們國內(nèi)訪問 GitHub 的速度，可想之安裝速度慢的驚人，甚至出現(xiàn)訪問github.com地址超時的錯誤。此時，需要環(huán)境變量UV_PYTHON_INSTALL_MIRROR來幫忙了。

對于 macOS / Linux 用戶 (zsh/bash):

打開你的終端。
執(zhí)行下面的命令，把配置寫入你的 shell 配置文件（比如 .zshrc 或 .bashrc）。

# 推薦使用自建的Github加速
echo 'export UV_PYTHON_INSTALL_MIRROR="https://gh-proxy.com/https://github.com/astral-sh/python-build-standalone/releases/download"' >> ~/.bashrc

# 或者用https://ghfast.top/
# echo 'export UV_PYTHON_INSTALL_MIRROR="https://ghfast.top/https://github.com/astral-sh/python-build-standalone/releases/download"' >> ~/.bashrc

# 別忘了讓配置立刻生效
source ~/.bashrc

對于 Windows 用戶:

想永久生效，還是得添加系統(tǒng)環(huán)境變量。

右鍵“此電腦” -> “屬性” -> “高級系統(tǒng)設(shè)置” -> “環(huán)境變量”。
在“用戶變量”或“系統(tǒng)變量”里，點擊“新建”。
變量名填 UV_PYTHON_INSTALL_MIRROR
變量值填 https://ghfast.top/https://github.com/astral-sh/python-build-standalone/releases/download
一路確定，然后務(wù)必重啟你的終端（PowerShell, CMD, etc.）讓配置生效。