在 Python 中,uv 是一个快速的现代构建系统和包管理器(类似 pippoetry 或 pipenv),专注于速度和简洁性。

以下是其常用命令:

1. 基础操作

安装 uv

1

2

3

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

# 或通过 pip(不推荐,建议用官方脚本)

pip install uv

查看版本

1

uv --version

2. 环境管理

创建虚拟环境

1

2

uv venv  # 在当前目录创建 .venv 环境

uv venv myenv  # 指定环境名称

激活虚拟环境

1

2

3

4

# Linux/macOS

source .venv/bin/activate

# Windows (PowerShell)

.venv\Scripts\Activate.ps1

删除虚拟环境

1

rm -rf .venv  # 直接删除目录(uv 无专门命令)

3. 包管理

安装包

1

2

3

4

uv pip install requests  # 安装最新版

uv pip install requests==2.31.0  # 指定版本

uv pip install "requests>=2.30"  # 版本范围

uv pip install -e .  # 安装当前项目( editable 模式)

从 requirements.txt 安装

1

uv pip install -r requirements.txt

卸载包

1

uv pip uninstall requests

更新包

1

2

uv pip update requests  # 更新单个包

uv pip update  # 更新所有包(谨慎使用)

冻结依赖(生成 requirements.txt)

1

uv pip freeze > requirements.txt

4. 项目管理(类似 poetry)

初始化项目

1

uv init  # 创建 pyproject.toml(交互式)

安装项目依赖(根据 pyproject.toml)

1

2

uv sync  # 安装所有依赖(包括开发依赖)

uv sync --no-dev  # 只安装生产依赖

添加依赖

1

2

uv add requests  # 添加到生产依赖

uv add --dev pytest  # 添加到开发依赖(--dev 可简写为 -d)

移除依赖

1

2

uv remove requests

uv remove --dev pytest

构建项目(生成 wheel/sdist)

1

uv build

发布包到 PyPI

1

uv publish  # 需要先配置 PyPI 凭据

5. 运行命令

在虚拟环境中运行脚本

1

2

uv run python script.py  # 无需手动激活环境

uv run pytest  # 运行测试命令

uv 的设计目标是比传统工具(如 pip)快得多,且兼容 pip 的大部分功能,同时支持现代项目管理(通过 pyproject.toml)。

更多推荐