Windows 11 手動下載安裝配置 uv、配置國內源
本文對應的講解視頻鏈接：https://www.bilibili.com/video/BV1WnYTzZEpW
文章目錄
- Windows 11 手動下載安裝配置 uv、配置國內源
- 1. 下載、安裝、配置 uv
- 2. 參考信息
重要聲明：
uv 的安裝有很多種方式，您完全可以選擇任何自己喜歡的方式進行安裝，并不一定非得按照本教程進行安裝。
1. 下載、安裝、配置 uv
-
下載 uv
- 這里提供了國內的下載鏈接：https://download.csdn.net/download/qq_36462452/91881247
- 下載
Windows 11 手動下載安裝配置 uv 0.8.15、配置國內源（附贈綠色安裝包）.zip，右擊，選擇“全部解壓縮”，解壓到當前文件夾下 - 進入
Windows 11 手動下載安裝配置 uv 0.8.15、配置國內源（附贈綠色安裝包）文件夾，找到uv-x86_64-pc-windows-msvc.zip
-
右鍵點擊下載的壓縮檔
uv-x86_64-pc-windows-msvc.zip，選擇“全部解壓縮”，輸入目標路徑D:\soft\uv，點擊“提取”。
-
按
Win+R鍵，輸入SystemPropertiesAdvanced，敲回車，將打開“高級系統設置”。或者，你也可以通過 點擊桌面下方開始按鈕 -> 設置 -> 系統 -> 系統信息 -> 高級系統設置，最終與
SystemPropertiesAdvanced效果一致。
-
在彈出的“系統屬性”窗口中，點擊“環境變量”。
-
在“……的用戶變量(U)”中找到
Path變量，點擊“編輯”。
-
點擊“新建”，輸入
D:\soft\uv，選中、點擊“上移”將其移至列表頂部（確保優先使用），然后點擊“確定”。
-
配置國內源，方法如下：
- 在“……的用戶變量(U)”下，點擊“新建”
- 變量名填：
UV_DEFAULT_INDEX - 變量值填：
https://pypi.tuna.tsinghua.edu.cn/simple/ - 點擊“確定”
-
依次點擊“環境變量”和“系統屬性”窗口的“確定”保存設置。
-
創建收據文件（用于未來更新），方法如下：
-
按
Win + R鍵，輸入%LOCALAPPDATA%，按回車，會打開當前用戶的本地應用程序數據文件夾 -
新建一個文件夾命名為
uv
-
進入新建的
uv文件夾 -
創建一個文本文件，名為
uv-receipt.json，注意將.txt改為.json -
輸入以下內容，保存并關閉文件：
{"binaries":["uv.exe","uvx.exe","uvw.exe"],"binary_aliases":{},"cdylibs":[],"cstaticlibs":[],"install_layout":"flat","install_prefix":"D:\\soft\\uv","modify_path":true,"provider":{"source":"cargo-dist","version":"0.28.7"},"source":{"app_name":"uv","name":"uv","owner":"astral-sh","release_type":"github"},"version":"0.8.15"}
-
-
關閉所有已經打開的終端（PowerShell 和 CMD），右鍵點擊桌面，選擇“在終端中打開”，輸入
uv --version，如果輸出了類似uv 0.8.15 (8473ecba1 2025-09-03)這樣的內容，則說明安裝成功。
2. 參考信息
- uv 官網文檔：https://docs.astral.sh/uv/
- uv GitHub 項目首頁：https://github.com/astral-sh/uv
)
