SuperAPI AI 工具集

uv-project-setup

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:用 uv 初始化并配置新的 Python 项目,建立标准化、可复现的工程结构,包含依赖管理、Python 版本固定,以及为开发、测试、生产划分依赖分组。

主要能力与用法: 初始化:uv init my-project 后 cd my-project,或先 mkdir my-project && cd my-project 再 uv init;会生成 pyproject.toml、.python-version、README.md、main.py、.gitignore。 同步与运行:uv sync 在隔离环境安装依赖,uv run python main.py 启动开发。 版本固定:uv python pin 3.12 或 uv python pin 3.12.3,可用 cat .python-version 验证。 添加依赖:uv add requests httpx pandas;支持精确版本 uv add "fastapi==0.104.0"、版本区间 uv add "django>=4.2,<5.0" 及 extras,如 uv add "pandas[excel,plot]"。uv.lock 保证各环境可复现安装。 依赖分组:在 pyproject.toml 的 [dependency-groups] 下定义 dev、lint、docs 等;用 uv sync --all-groups、uv sync --group dev --group lint 或 uv sync --no-dev 按需安装。 工具与扩展配置:在 [tool.uv] 下配置 conflicts、environments;在 [project.optional-dependencies] 定义 extras,在 [project.scripts] 定义 CLI 入口。 验证:uv tree 查看依赖树;可手动激活 .venv(source .venv/bin/activate 或 .venv\Scripts\activate)。

适用场景:Web 开发、数据科学、库项目、多平台项目,以及内联依赖脚本和自定义包源([tool.uv.sources]、自定义 index)。

限制与注意:需固定 Python 版本并把 .python-version 提交版本控制;开发工具应放入 dev 分组避免进入生产;uv.lock 应提交,CI 可用 uv sync --frozen;包构建需定义 [build-system];冲突依赖可用 conflicts 或分组隔离。资料未提供收费标准、具体平台支持范围及效果数据。