SuperAPI AI 工具集

uv

编程与开发

查看项目

更新于 10-15 22:15

技能介绍

用途:uv 是 Python 包与项目管理器,替代 pip、pip-tools、pipx、pyenv、virtualenv、poetry,用 Rust 编写,速度比同类快 10-100 倍。属稳定生产软件,次版本可能含破坏性变更,补丁版本不破坏兼容。

主要能力:按场景分为项目、脚本、工具、Python 版本、pip 接口、构建发布六类工作流。项目侧支持 uv init 初始化、uv add/remove 管理依赖、uv sync 同步、uv run 运行、uv lock 锁定、uv export 导出;脚本侧支持 PEP 723 内联依赖;工具侧用 uvx 隔离运行或 uv tool install 持久安装;Python 侧可安装、固定、升级解释器;还支持工作区、版本管理与发布。

必要用法:先运行 uv --version,命令标志不确定时用 uv <command> --help。关键规则:存在 pyproject.toml 时用项目命令(uv add、uv sync、uv run),不要在项目内用 uv pip install,否则绕过锁文件。CI 中可用 uv sync --locked 或 uv lock --check。

适用场景:Python 项目依赖管理、单文件脚本、CLI 工具运行、解释器管理、旧 requirements.txt 迁移、打包发布。

限制:本技能不替代 uv --help 的完整标志发现;不适用于 Poetry/PDM 项目;不涉及 C/Rust 扩展构建;不涉及 ruff/ty 配置。部分功能(如 uv audit、uv format、pylock)为 0.10+ 预览特性,需 --preview 或 UV_PREVIEW=1 启用,本地安装版本可能尚未包含。快照版本 v0.11.11,以实际安装的二进制为准。