快捷導(dǎo)航

使用uv管理Python項(xiàng)目的詳細(xì)說明

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

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

1. 安裝 uv

uv 是由 Astral 推出的基于 Rust 編寫的 Python 包和項(xiàng)目管理工具，號(hào)稱“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 初始化項(xiàng)目非常簡單。只需創(chuàng)建一個(gè)空文件夾，然后運(yùn)行：

uv init myproject

這會(huì)在項(xiàng)目目錄中生成以下幾個(gè)文件：

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

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

首次進(jìn)入項(xiàng)目后，運(yùn)行以下命令可自動(dòng)：

uv sync

運(yùn)行后，若項(xiàng)目沒有額外依賴，uv.lock 文件中只會(huì)記錄最基本的信息。

如果需要手動(dòng)管理虛擬環(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

這時(shí)，uv 會(huì)自動(dòng)解決 pandas 及其依賴，并更新 pyproject.toml（記錄依賴）和 uv.lock（記錄所有詳細(xì)依賴版本信息）。

刪除依賴也同樣簡單：

uv remove pandas

此命令會(huì)自動(dòng)卸載 pandas 及其不再需要的依賴，同時(shí)更新鎖定文件。

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

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

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

uv run hello.py

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

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

這些命令使得整個(gè)項(xiàng)目管理體驗(yàn)更為統(tǒng)一和高效。

當(dāng)前目錄下默認(rèn)用的python版本是uv python find對應(yīng)版本.
當(dāng)前目錄下指定版本用uv python pin <version>會(huì)在當(dāng)前目錄下生成一個(gè).python-version文件。
指定的Python版本運(yùn)行指令: uv init/add/remove/run/pip -p <version>。

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

您可能感興趣的文章: