reference/docs/uv.md

uv 备忘清单

一个用 Rust 编写的极快的 Python 包和项目管理工具

安装

使用独立安装程序安装

macOS or Linux

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

Windows

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

通过PyPI

# pip
pip install uv

# pipx
pipx install uv

入门

创建新项目

# 创建一个目录作为项目的根目录
uv init project_name

# 将当前目录作为项目的根目录
uv init

项目的结构

.
├── .venv/           # 虚拟环境目录
│   ├── bin/         # 可执行文件
│   ├── lib/         # 安装的库
│   └── pyvenv.cfg   # 虚拟环境配置
├── .python-version  # 指定 Python 版本
├── README.md        # 项目说明文档
├── main.py          # 主程序入口
├── pyproject.toml   # 项目配置与依赖声明
└── uv.lock          # 依赖锁定文件（自动生成）

管理项目依赖

添加依赖

uv add requests

指定依赖版本或替代来源

# 指定版本
uv add 'requests==2.28.1'

# 指定来源
uv add git+https://github.com/psf/requests

从requirements.txt迁移

uv add -r requirements.txt

删除一个包

uv remove requests

升级一个包

uv lock --upgrade-package requests

运行脚本

指定脚本运行

uv run main.py

指定Python版本运行

uv run --python 3.10 main.py

构建项目

uv build

构建结果存储在dist目录下