uv Usage 是一份关于使用 uv（Python 包管理器）的简明指导，帮助用户以快速、统一的方式管理 Python 项目与脚本。
用途 用于在 Python 项目中使用 uv 完成依赖管理、环境同步、命令运行、版本管理以及独立脚本的依赖声明。
主要能力
- 项目工作流：初始化项目（uv init）、添加依赖（uv add <package>）、同步环境（uv sync）、运行命令（uv run <cmd>）。uv add 会自动更新 uv.lock；在手动编辑 pyproject.toml 后需要重新锁定可使用 uv lock。
- PEP 723 内联依赖脚本：通过内联元数据让脚本独立运行，使用 uv run <script-file>。步骤为：在文件顶部添加 # /// script 块；设置 requires-python 与 dependencies；用 uv run <script-file> 运行脚本；用 uv add --script 和 uv remove --script 增加或移除内联依赖。模板如下：
/// script
requires-python = ">=3.11"
dependencies = [
"requests>=2.31",
"rich>=13.0",
]
///
import requests from rich import print
print(requests.get("https://api.github.com/repos/astral-sh/uv").status_code)
对应命令：uv run script.py、uv add --script script.py beautifulsoup4、uv remove --script script.py rich。 3. 兼容 pip 的命令：适用于替代式工作流或旧项目，包括 uv pip install <package>、uv pip install -r requirements.txt、uv pip compile requirements.in -o requirements.txt、uv pip sync requirements.txt。 4. Python 版本与环境：uv python install 3.12、uv python pin 3.12、uv venv --python 3.12、uv run --python 3.12 -- python -V。
示例 新项目：uv init demo；cd demo；uv add ruff；uv run ruff check .。 带内联依赖的独立脚本：uv run script.py。
使用方式 按上述命令直接调用 uv，新项目优先采用项目工作流（uv add、uv sync），手动修改 pyproject.toml 后使用 uv lock 重新锁定。
适用场景 新建或维护 Python 项目、管理依赖与虚拟环境、指定 Python 版本、编写带内联依赖的独立脚本、需要兼容 pip 的旧项目。
限制 uv 提供兼容 pip 的命令，但在边缘情况下行为可能存在差异；除资料中列出的命令与说明外，其他功能、收费、平台与效果暂未提供。