SuperAPI AI 工具集

python-uv

编程与开发

查看项目

更新于 10-15 12:10

技能介绍

用途

python-uv 是一份面向 Python 开发的技能指南,主题是使用 uv 进行依赖管理。uv 被描述为快速的 Python 包安装器与解析器。该技能的核心指令是:所有 Python 依赖都必须使用 uv 进行安装、同步和锁定;不得直接使用 pip、pip-tools 或 poetry 进行依赖管理。

主要能力

该技能围绕 uv 的依赖管理能力展开,涵盖以下方面:

  • 标准项目的依赖管理:使用 uv add <package> 添加依赖,使用 uv remove <package> 移除依赖,使用 uv sync 同步依赖。
  • 脚本管理:使用 uv run script.py 执行脚本,并处理其依赖。
  • 手动内联元数据配置:脚本可以通过注释块指定依赖,例如:
# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "torch",
#   "torchvision",
#   "opencv-python",
#   "numpy",
#   "matplotlib",
#   "Pillow",
#   "timm",
# ]
# ///
print("some python code")
  • 基于 CLI 的脚本依赖管理:使用 uv add package-name --script script.py 为脚本添加依赖,使用 uv remove package-name --script script.py 移除脚本依赖,使用 uv sync --script script.py 同步脚本依赖。

使用方式

该技能以指南形式给出操作规范。在标准项目中,通过 uv add、uv remove、uv sync 管理依赖;对于独立脚本,优先使用内联脚本元数据声明依赖,并通过 uv run 执行;也可以通过 CLI 的 --script 参数直接为指定脚本增删或同步依赖。

适用场景

适用于需要以 uv 统一管理 Python 依赖的项目与脚本开发场景,尤其是希望避免混用 pip、pip-tools 或 poetry 的团队或个人开发者。对于独立脚本,内联元数据方式便于将依赖声明与脚本本身放在一起。

限制

该技能明确要求不得回退到 pip 或其他包管理器。资料未提供 uv 的安装方法、版本要求、平台支持、性能数据或收费信息,这些内容暂未提供。