一、Python 版本管理

1. 查看已安裝的 Python 版本

uv python list

• 輸出示例：

  Installed Python versions:
  - 3.11.5 (default)
  - 3.12.0
  

2. 安裝指定 Python 版本

uv python install 3.12.0  # 安裝 Python 3.12.0

• 支持安裝任意版本（如 3.9.18、3.13.0 等）。
• 安裝完成后，通過 uv python list 驗證是否成功。

3. 切換項目 Python 版本

uv python pin 3.12.0  # 將當前項目鎖定到 Python 3.12.0

• 此命令會在項目根目錄生成 .python-version 文件，記錄版本信息。
• 后續(xù)所有操作（如創(chuàng)建虛擬環(huán)境、運行腳本）均默認使用此版本。

二、虛擬環(huán)境管理

1. 創(chuàng)建虛擬環(huán)境并指定 Python 版本

uv venv --python 3.12.0  # 創(chuàng)建名為 .venv 的虛擬環(huán)境，使用 Python 3.12.0

• 若未指定 --python，默認使用項目鎖定的版本（通過 uv python pin 設置）。

2. 激活虛擬環(huán)境

# Linux/macOS
source .venv/bin/activate

# Windows
.venv\Scripts\activate

• uv 推薦直接使用 uv run 命令運行腳本，無需手動激活環(huán)境：

  uv run script.py  # 自動激活虛擬環(huán)境并執(zhí)行腳本
  

三、依賴管理

1. 同步依賴項

在項目根目錄運行以下命令，根據 pyproject.toml 或 requirements.txt 安裝依賴：

uv sync  # 安裝所有依賴并生成/更新 uv.lock 文件

• 按分組安裝依賴：

  uv sync --only prod    # 僅安裝生產依賴
  uv sync --only dev     # 僅安裝開發(fā)依賴
  

2. 添加新依賴并同步

uv add requests==2.31.0      # 添加生產依賴
uv add --group dev pytest    # 添加開發(fā)依賴
uv sync                      # 更新依賴并生成鎖定文件

四、多版本 Python 場景示例

場景：項目 A 使用 Python 3.11，項目 B 使用 Python 3.12

• 初始化項目 A

  cd project_a
  uv python pin 3.11.5    # 鎖定 Python 版本
  uv venv                 # 創(chuàng)建虛擬環(huán)境
  uv add numpy            # 添加依賴
  uv sync
  

• 初始化項目 B

  cd project_b
  uv python pin 3.12.0    # 鎖定 Python 版本
  uv venv
  uv add pandas
  uv sync
  

• 運行腳本

  cd project_a
  uv run main.py  # 使用 Python 3.11 和 project_a 的依賴
  
  cd ../project_b
  uv run main.py  # 使用 Python 3.12 和 project_b 的依賴
  

五、常用命令總結

六、注意事項

• 全局 Python 版本uv 默認通過虛擬環(huán)境隔離 Python 版本，無需全局切換。每個項目獨立管理版本。

• 依賴鎖定文件提交 uv.lock 到版本控制，確保團隊成員和 CI/CD 環(huán)境的一致性。

• 性能優(yōu)化利用 uv 的全局緩存加速依賴安裝（默認路徑：~/.cache/uv）。

通過上述操作，uv 可實現(xiàn)從 Python 版本管理到依賴同步的全流程高效控制。

到此這篇關于Python包管理工具uv常用場景使用的文章就介紹到這了,更多相關Python包管理工具uv使用內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論