SuperAPI AI 工具集

python-uv

编程与开发

查看项目

更新于 10-16 04:30

技能介绍

用途:为使用 uv(Astral 的 Python 包与项目管理器)管理 Python 项目提供工作流与最佳实践,适用于初始化项目、管理依赖、锁定与同步环境、运行脚本、构建与发布。

主要能力:用 uv init 创建项目并生成 pyproject.toml、.python-version、README.md、main.py 等结构;首次 uv run、uv sync 或 uv lock 后生成 .venv/ 与 uv.lock。依赖管理支持 uv add(含版本约束、extras、平台标记)、uv add --dev 与 --group 分组、uv remove、uv lock --upgrade-package 与 --upgrade。运行统一用 uv run,可执行脚本、环境内工具、一次性依赖(--with)及指定分组(--no-default-groups --group)。同步与锁定包括 uv sync、--all-groups、--group、uv lock、uv lock --check。构建与版本用 uv build、uv version。依赖来源支持本地可编辑路径、Git 仓库与标签、自定义索引,并用 --no-sources 验证发布元数据。

使用方式:核心命令如 uv init my-project、uv add requests、uv add --dev pytest ruff mypy、uv run main.py、uv sync、uv lock --check、uv build。项目内不要用 uv pip install,应使用 uv add;脚本与 CI 中优先 uv run,一次性工具可用 uvx。

适用场景:新项目搭建、依赖与分组管理、可复现环境、CI 锁定校验、库的构建发布。

限制:资料未提供 uv 的安装方式、版本要求、性能数据、收费信息及具体平台支持范围;tool.uv.sources 为 uv 专有开发特性,发布前需用 --no-sources 校验。