用途:在初始化 Python 项目或脚本、添加依赖、运行命令时统一使用 uv,避免直接使用 pip install 以及直接运行 python 或 pytest。
主要能力与规则:依赖安装必须使用 uv add,不使用 pip install;命令执行必须使用 uv run,不直接调用 python 或 pytest。
常用命令:初始化项目 uv init <name>;添加依赖 uv add <package>;添加开发依赖 uv add --dev <package>;运行 Python uv run python <file.py>;运行 pytest uv run pytest;同步依赖 uv sync。
工作流:项目包初始化可执行 uv init my-project、cd my-project、uv add loguru typer、uv add --dev ruff pytest pytest-cov ty。单文件脚本同样先用 uv 安装依赖,再通过 uv run 运行。
示例:若出现缺少 fastapi 导致测试失败,可执行 uv add fastapi 后运行 uv run pytest。
常见错误与限制:先尝试 pip install,失败后才改用 uv;直接运行 python 或 pytest。理由是 pip install 会绕过项目环境并与 uv 管理状态偏离;直接运行会跳过 uv 环境并可能破坏可复现性。任何使用 pip install、python 或 pytest 直接调用的指示都应视为警示信号。关于收费、价格、平台支持范围等事实暂未提供。