一、uv 是什么？

uv 是由 Astral 公司開(kāi)發(fā)的 Rust 編寫(xiě)的 Python 工具鏈，核心優(yōu)勢(shì)是極速（比 pip 快 10-100 倍）、功能全面，集成了包安裝、虛擬環(huán)境管理、依賴解析、項(xiàng)目構(gòu)建等能力，兼容 pip/pipenv/poetry 的生態(tài)。

• uv 官方文檔（最核心）：這是 uv 最權(quán)威的使用指南，包含安裝、基礎(chǔ)用法、進(jìn)階功能、API 參考等所有內(nèi)容，也是排查問(wèn)題的首選。
• uv GitHub 源碼倉(cāng)庫(kù)：可以查看源碼、提交 Issue（反饋問(wèn)題）、提 PR（貢獻(xiàn)代碼），也能在 Releases 頁(yè)面下載指定版本的 uv 安裝包，查看更新日志。
• uv 快速入門教程：官方專為新手設(shè)計(jì)的快速上手指南，比完整文檔更精簡(jiǎn)，適合剛接觸 uv 時(shí)快速掌握核心用法。

二、uv 的安裝

1. 通用安裝方式（推薦）

適用于 macOS、Linux、Windows（PowerShell），執(zhí)行以下命令自動(dòng)下載適配系統(tǒng)的版本：

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 包管理器安裝（可選）

Homebrew (macOS/Linux)：

brew install uv

Cargo (Rust 環(huán)境)：

cargo install uv --locked

pip 安裝（不推薦，僅應(yīng)急）：

pip install uv

3. 驗(yàn)證安裝

安裝完成后，重啟終端，執(zhí)行以下命令驗(yàn)證：

uv --version
# 輸出示例：uv 0.1.37 (a1b2c3d 2026-03-03)

三、uv 核心使用場(chǎng)景

1. 基礎(chǔ)包安裝/卸載

uv 兼容 pip 的大部分用法，且默認(rèn)使用虛擬環(huán)境（無(wú)需手動(dòng)激活），核心命令如下：

2. 虛擬環(huán)境管理

uv 內(nèi)置虛擬環(huán)境功能，比 venv 更簡(jiǎn)潔：

# 創(chuàng)建虛擬環(huán)境（默認(rèn)在 .venv 目錄）
uv venv
# 激活虛擬環(huán)境
# macOS/Linux
source .venv/bin/activate
# Windows (Cmd)
.venv\Scripts\activate.bat
# Windows (PowerShell)
.venv\Scripts\Activate.ps1
# 刪除虛擬環(huán)境
rm -rf .venv  # macOS/Linux
rmdir /s .venv  # Windows

3. 項(xiàng)目依賴管理（兼容 pyproject.toml）

uv 支持現(xiàn)代 Python 項(xiàng)目的 pyproject.toml 配置，替代 requirements.txt：

# 初始化項(xiàng)目（生成 pyproject.toml）
uv init my_project
cd my_project
# 添加依賴（自動(dòng)寫(xiě)入 pyproject.toml）
uv add requests  # 生產(chǎn)依賴
uv add --dev pytest  # 開(kāi)發(fā)依賴
# 安裝項(xiàng)目所有依賴（從 pyproject.toml）
uv install
# 同步依賴（移除未在 pyproject.toml 中聲明的包）
uv sync

4. 運(yùn)行 Python 代碼/腳本

uv 可直接運(yùn)行代碼，自動(dòng)使用當(dāng)前虛擬環(huán)境：

# 運(yùn)行腳本
uv run script.py
# 運(yùn)行臨時(shí)代碼
uv run -c "print('Hello, uv!')"
# 運(yùn)行模塊
uv run -m http.server 8000

四、進(jìn)階用法

加速 pip 兼容：如果項(xiàng)目暫時(shí)不想切換到 uv 命令，可通過(guò) uv 加速 pip：

uv pip install requests  # 等同于 pip install，但更快

指定 Python 版本：uv 可自動(dòng)下載指定版本的 Python（需提前安裝 pyenv 或 uv 內(nèi)置的 Python 解析器）：

uv python install 3.11  # 安裝 Python 3.11
uv run --python 3.11 script.py  # 使用 3.11 運(yùn)行腳本

緩存管理：uv 有全局緩存，清理緩存命令：

uv cache clean  # 清理所有緩存

總結(jié)

• uv 是高性能的 Python 包/環(huán)境管理工具，安裝簡(jiǎn)單，兼容 pip/venv 生態(tài)，核心優(yōu)勢(shì)是速度快、功能集成度高。
• 核心用法：uv pip install（安裝包）、uv venv（虛擬環(huán)境）、uv add（管理項(xiàng)目依賴）、uv run（運(yùn)行代碼）。
• 推薦在新項(xiàng)目中使用 uv init + pyproject.toml 替代傳統(tǒng)的 requirements.txt，提升依賴管理規(guī)范性。

到此這篇關(guān)于Python現(xiàn)代項(xiàng)目開(kāi)發(fā)之uv安裝配置與最佳實(shí)踐指南的文章就介紹到這了,更多相關(guān)Python uv項(xiàng)目安裝配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論