SuperAPI AI 工具集

uv-tool-management

编程与开发

查看项目

更新于 10-15 20:34

技能介绍

用途:教你用 uv 高效管理 Python 命令行工具,包括免安装按需运行、全局持久安装、版本管理与升级,并区分工具与项目依赖的适用场景。uv 在此场景替代 pipx,提供三种方式:uvx 临时执行(工具在隔离环境中获取、缓存并运行,不修改系统,适合偶尔使用、试用工具或 CI/CD);uv tool install 持久安装(安装到独立全局环境并加入 PATH,适合日常使用的 linter、formatter、test runner);uv run 在项目虚拟环境中运行(可访问项目已安装包,适合对项目代码做测试、检查、格式化)。

主要能力:用 uvx 运行工具并指定版本(如 uvx ruff@0.3.0)、版本约束、从不同包运行命令(uvx --from httpie http)、附加 extras、指定 Python 版本、从 git 仓库运行;用 uv tool install 安装、列出(uv tool list)、升级(uv tool upgrade、--all)、卸载(uv tool uninstall)与固定版本;区分 pyproject.toml 中项目依赖、可选依赖与开发所用 dependency-groups;处理依赖冲突与缓存清理(uv cache prune)。

使用方式:常用命令保持原样,例如 uvx ruff check .、uv tool run ruff check .、uv tool install ruff、uv tool install 'mypy[faster-cache]'、uvx --python 3.10 ruff check .、uv sync --group lint、uv run pytest tests/。需要先安装 uv:curl -LsSf https://astral.sh/uv/install.sh | sh,并需 Python 3.8+。

适用场景与限制:适合工具试用、跨项目工具复用、CI 流水线与多 Python 版本验证;要求理解项目依赖结构。文档中的决策矩阵、参考文件与示例属于该技能附带资料,具体效果与兼容性未在资料中给出。工具与项目依赖的边界、版本固定策略需按团队约定,其他收费或平台信息暂未提供。