一、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 驗(yàn)證是否成功。

3. 切換項(xiàng)目 Python 版本

uv python pin 3.12.0  # 將當(dāng)前項(xiàng)目鎖定到 Python 3.12.0

• 此命令會(huì)在項(xiàng)目根目錄生成 .python-version 文件，記錄版本信息。
• 后續(xù)所有操作（如創(chuàng)建虛擬環(huán)境、運(yùn)行腳本）均默認(rè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，默認(rèn)使用項(xiàng)目鎖定的版本（通過 uv python pin 設(shè)置）。

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

# Linux/macOS
source .venv/bin/activate

# Windows
.venv\Scripts\activate

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

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

三、依賴管理

1. 同步依賴項(xiàng)

在項(xiàng)目根目錄運(yùn)行以下命令，根據(jù) pyproject.toml 或 requirements.txt 安裝依賴：

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

• 按分組安裝依賴：

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

2. 添加新依賴并同步

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

四、多版本 Python 場景示例

場景：項(xiàng)目 A 使用 Python 3.11，項(xiàng)目 B 使用 Python 3.12

• 初始化項(xiàng)目 A

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

• 初始化項(xiàng)目 B

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

• 運(yùn)行腳本

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

五、常用命令總結(jié)

六、注意事項(xiàng)

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

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

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

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

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

最新評(píng)論