使用uv管理Python項目的詳細說明

更新時間：2025年06月09日 10:12:11 作者：pinshig

uv是Astral推出的Rust驅(qū)動Python項目管理工具,支持安裝、初始化、依賴管理與虛擬環(huán)境配置,這篇文章主要介紹了使用uv管理Python項目的詳細說明,需要的朋友可以參考下

1. 安裝 uv

uv 是由 Astral 推出的基于 Rust 編寫的 Python 包和項目管理工具，號稱“Python 的 Cargo”。你可以通過多種方式安裝 uv，例如：

macOS/Linux：

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

Windows：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安裝后，可使用 uv help 檢查是否安裝成功。

使用 uv 初始化項目非常簡單。只需創(chuàng)建一個空文件夾，然后運行：

uv init myproject

這會在項目目錄中生成以下幾個文件：

例如，創(chuàng)建成功后的目錄結(jié)構(gòu)可能如下：

myproject/
  ├── .gitignore
  ├── .python-version
  ├── hello.py
  ├── pyproject.toml
  └── README.md

首次進入項目后，運行以下命令可自動：

uv sync

運行后，若項目沒有額外依賴，uv.lock 文件中只會記錄最基本的信息。

如果需要手動管理虛擬環(huán)境，你可以使用：

創(chuàng)建虛擬環(huán)境：
```
uv venv myenv
```
若需要指定 Python 版本：
```
uv venv --python /path/to/python myenv
```
激活虛擬環(huán)境：Linux/macOS 下：
```
source myenv/bin/activate
```
Windows 下：
```
myenv\Scripts\activate
```

uv 提供了類似于 npm 或 Cargo 的依賴管理命令，可以非常便捷地添加、刪除或更新依賴包。

例如，添加 pandas 依賴：

uv add pandas

這時，uv 會自動解決 pandas 及其依賴，并更新 pyproject.toml（記錄依賴）和 uv.lock（記錄所有詳細依賴版本信息）。

刪除依賴也同樣簡單：

uv remove pandas

此命令會自動卸載 pandas 及其不再需要的依賴，同時更新鎖定文件。

你還可以為開發(fā)環(huán)境和生產(chǎn)環(huán)境分別添加依賴，例如：

這些分組信息會記錄在 pyproject.toml 的 [dependency-groups] 部分。

與傳統(tǒng)直接調(diào)用 python hello.py 不同，uv 建議你使用統(tǒng)一的命令來運行項目代碼。你可以使用：

uv run hello.py

該命令會自動在項目的虛擬環(huán)境中執(zhí)行代碼，確保所有依賴都已正確安裝。

uv pip：提供與 pip 兼容的接口管理包，例如安裝、卸載、列出包等。
uv lock：根據(jù) pyproject.toml 更新或生成 uv.lock 文件，記錄所有包的精確版本。
uv tree：以樹狀結(jié)構(gòu)顯示項目的依賴關系，幫助你快速了解依賴層次結(jié)構(gòu)。
uv python find：查找已安裝的 Python 版本。
uv python list：列出可供安裝的 Python 版本以及系統(tǒng)中已安裝的版本。
uv python install <version>：將 <version> 替換為您希望安裝的多個 Python 版本號，例如 3.10 3.11 3.12 pypy@3.10。
uv python pin <version>：固定當前目錄下使用的python版本。
uv run -p <version> python：進入指定python版本的解釋器交互環(huán)境。