uv 是 Rust 編寫的新一代極速 Python 環(huán)境/包管理工具，兼容 pip/venv 語法且速度提升 10-100 倍，以下是全場景命令匯總和避坑指南，覆蓋環(huán)境創(chuàng)建、包管理、依賴鎖定等核心場景，適配 Windows/macOS/Linux。另外，為了便于pip用戶遷移，安裝包時(shí)使用uv pip install，另外也推薦使用uv add 安裝依賴，uv remove卸載依賴。

一、核心命令分類匯總

1. 環(huán)境管理（venv）

激活環(huán)境（Windows）：

# 激活默認(rèn)環(huán)境
.venv\Scripts\Activate
# 激活自定義環(huán)境
venv_test  \Scripts\Activate
# 退出環(huán)境
deactivate

2. 包安裝/卸載（pip）

uv pip 完全兼容 pip 語法，且速度遠(yuǎn)快于 pip，核心命令：

3. 依賴鎖定（lock）

uv 支持生成鎖文件（類似 poetry/pipenv），確保環(huán)境一致性：

4. 全局配置/工具命令

二、配置及運(yùn)行單個(gè)腳本

初始化腳本項(xiàng)目
uv init --script analyze.py
添加腳本依賴
uv add pandas --script analyze.py
運(yùn)行腳本（自動(dòng)處理依賴）
uv run analyze.py

三、uv python命令

uv python list
#List the available Python installations
uv python install
#Download and install Python versions
uv python upgrade
#Upgrade installed Python versions
uv python find
#Search for a Python installation
uv python pin
#Pin to a specific Python version
uv python dir
#Show the uv Python installation directory
uv python uninstall
#Uninstall Python versions
uv python update-shell
#Ensure that the Python executable directory is on the PATH

四、關(guān)鍵注意事項(xiàng)（避坑指南）

1. 環(huán)境創(chuàng)建與激活

• 避免在同一目錄重復(fù)創(chuàng)建 .venv：若提示「環(huán)境已存在」，要么復(fù)用（選擇現(xiàn)有解釋器），要么改名創(chuàng)建（如 .venv_ct），不要直接覆蓋。
• Windows 激活報(bào)錯(cuò)「禁止運(yùn)行腳本」：以管理員身份打開 PowerShell，執(zhí)行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，輸入 Y 確認(rèn)。
• 建議按功能命名環(huán)境：如 .venv_ct（CT 圖像處理）、.venv_ml（機(jī)器學(xué)習(xí)），便于區(qū)分。

2. 包安裝兼容性

不要混用 uv pip 和 pip：同一環(huán)境中用 uv 安裝后，再用 pip 可能導(dǎo)致依賴沖突，全程用 uv pip。

安裝舊版包（如 opencv-python==4.1.0）時(shí)，若提示找不到版本：檢查 Python 版本兼容性（如 4.1.0 不支持 Python 3.12），需指定對應(yīng) Python 版本創(chuàng)建環(huán)境。

安裝本地包時(shí)，確保目錄有 pyproject.toml/setup.py，否則會(huì)報(bào)錯(cuò)。

3. 鏡像源配置（解決下載慢）

默認(rèn)使用官方 PyPI，國內(nèi)建議配置清華/阿里鏡像：

# 臨時(shí)使用（單次安裝）
uv pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple

# 全局配置（永久生效）
uv config set registry.index-url https://pypi.tuna.tsinghua.edu.cn/simple

4. Python 版本管理

• uv 自動(dòng)下載的 Python 版本存儲(chǔ)在獨(dú)立目錄，不影響系統(tǒng) Python，可通過 uv python list 查看。
• 創(chuàng)建環(huán)境時(shí)指定的 Python 版本若未安裝，uv 會(huì)自動(dòng)下載，但需保證網(wǎng)絡(luò)通暢（可配置國內(nèi)鏡像加速）。
• Windows 下若提示「Python 版本找不到」：檢查環(huán)境變量，或手動(dòng)執(zhí)行 uv python install <版本> 預(yù)安裝。

5. 與 PyCharm 集成

• 添加解釋器時(shí)，選擇「現(xiàn)有環(huán)境」，路徑指向 <環(huán)境目錄>\Scripts\python.exe（Windows）。
• 切換環(huán)境后，PyCharm 可能需要幾秒加載依賴，耐心等待「索引完成」。
• 若 PyCharm 識(shí)別不到 uv 環(huán)境：重啟 PyCharm，或手動(dòng)刷新解釋器列表。

6. 緩存與清理

• uv 緩存默認(rèn)占空間較小，但若需清理，執(zhí)行 uv pip cache purge 即可。
• 舊環(huán)境可直接刪除文件夾（如 .venv_old），無殘留（區(qū)別于 conda）。

五、常用場景速查表

六、總結(jié)

uv 核心優(yōu)勢是「極速+兼容」：uv venv 替代 python -m venv，uv pip 替代 pip，語法完全兼容且速度大幅提升；

環(huán)境管理關(guān)鍵是「自定義命名+避免覆蓋」，包管理需「全程用 uv pip、不混用 pip」；

國內(nèi)使用必配鏡像源，Windows 需解決 PowerShell 執(zhí)行策略問題，與 PyCharm 集成時(shí)指向正確的 Python 可執(zhí)行文件。

以上就是Python包管理工具uv的命令大全(附核心注意事項(xiàng))的詳細(xì)內(nèi)容，更多關(guān)于Python uv命令的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論