用途:在所有需要运行 Python 代码或管理 Python 依赖的场景中,统一使用 uv,替代 pip 或直接使用 python。
主要能力与用法:
- 管理依赖:进入 Python 项目后使用 uv init、uv add、uv sync 等命令管理依赖,并用 uv run 运行脚本。
- 运行独立脚本:不直接执行 python script.py,而使用 uv run --script script.py。脚本可在头部用注释声明依赖,例如: #!/usr/bin/env -S uv run --script
/// script
requires-python = ">=3.12"
dependencies = [
"requests",
]
///
- 运行第三方工具:一次性执行可用 uv tool run <tool-name>,简写为 uvx <tool-name>。
环境与版本偏好:
- 默认推荐并设置 Python 3.12。
- 编写代码时使用类型提示。
- 若 uv 未安装,应请用户按操作系统执行类似 brew install uv 的安装,或经用户同意代为安装。
- 在沙箱模式下,需要将 uv 缓存目录加入允许路径,可在 PROJECTDIR/.claude/settings.local.json 中添加: { "permissions": { "allow": [ "Read(~/.cache/uv)", "Edit(~/.cache/uv)" ] } } 这样 uv 在沙箱中也能读写缓存。
复杂脚本与项目:
- 对于项目或非常复杂的独立脚本,将 ruff(linter/formatter)和 ty(类型检查器)配置为开发依赖,并在修改 Python 源码后运行两者。
- 如需更复杂的 uv 交互或排查问题,可参考 https://docs.astral.sh/uv/llms.txt 及其链接页面;仅运行脚本或添加依赖时无需查阅。
限制:以上为资料明确说明的使用约定,未提及具体收费、价格、支持平台范围或其他功能。