用途:在创建 Python 项目、增删依赖、运行脚本或工具、管理虚拟环境及 Python 版本时使用。资料称其比 pip 快 10-100 倍,并用锁文件保证可复现构建。
主要能力与常用命令: 项目:uv init 创建项目;uv init --package my-lib 创建可安装包;uv init --python 3.11 指定版本。 依赖:uv add requests、uv add --dev pytest、uv add "django>=4.2,<5.0"、uv add --git <url> --branch develop、uv remove package-name。 运行:uv run script.py、uv run pytest、uv run python -m module;uv run --with httpx fetch_data.py 可临时带依赖运行。 环境:uv sync 同步依赖,uv sync --frozen 在 CI/CD 中不改锁文件,uv lock 更新锁文件,uv venv 手动创建环境。 Python 版本:uv python list 列出,uv python install 3.12 安装。 迁移:uv init 后 uv add -r requirements.txt 导入;开发依赖用 uv add --dev -r。
使用方式:首次执行 uv sync、uv add 或 uv run 时自动创建 .venv 虚拟环境,一般无需手动激活,直接用 uv run 运行即可。生成的项目结构包含 .python-version、pyproject.toml、.venv 和示例脚本。建议提交 pyproject.toml、uv.lock、.python-version,不要提交 .venv,避免混用 pip 与 uv。
限制与说明:资料未提供收费、平台支持范围及具体性能测试数据;部分细节(如 Docker 集成、monorepo 工作区、CI/CD 配置)需参见仓库中的 AgentUsage/uv_usage.md。