使用 uv 安装开发环境依赖,核心做法是运行 uv sync。该命令会自动读取项目根目录下的 pyproject.toml 或 uv.lock 文件,解析其中定义的依赖关系,并在当前虚拟环境中完成安装。如果本地尚未创建虚拟环境,uv sync 会默认在当前目录下创建一个名为 .venv 的隔离环境;若需指定其他路径,可通过 --directory 参数指向目标项目文件夹执行。此操作确保了生产依赖与开发依赖(如测试工具、类型检查器)的一致性。

如何初始化一个包含开发依赖的新项目
要初始化一个包含开发依赖的新项目,应使用 uv init 命令并配合 --dev 标志。该命令会在当前目录生成 pyproject.toml 和 uv.lock 文件,并将指定的包标记为开发依赖。随后通过 uv sync 即可将这些包安装到虚拟环境中。这种方式比手动编辑配置文件更可靠,因为它能自动处理版本约束和锁文件的生成。

uv init my-project --dev pytest mypy cd my-project uv sync
上述命令执行后,pytest 和 mypy 会被添加到 pyproject.toml 的 dependency-groups.dev 部分。运行 uv sync 后,这些包将被安装在 .venv 中,且不会污染全局 Python 环境。开发者可以直接在虚拟环境中运行 pytest 或 mypy 进行代码验证。
如何更新已存在的开发依赖版本
更新已存在的开发依赖版本,需使用 uv add 命令并指定 --dev 标志及新的版本约束。该命令会修改 pyproject.toml 中的依赖声明,并重新计算依赖树以生成新的 uv.lock 文件。最后通过 uv sync 将变更应用到虚拟环境中。这一流程确保了依赖版本的精确控制和环境的一致性。

uv add --dev pytest==7.4.0 uv sync
执行 uv add --dev pytest==7.4.0 后,pyproject.toml 中对应条目会被更新为确切版本。接着运行 uv sync,uv 会下载并安装指定版本的 pytest,同时移除旧版本。开发者可通过 uv pip list 验证安装结果,确保环境中仅存在预期的开发依赖版本。
当 pyproject.toml 缺少 dependency-groups.dev 时 uv sync 的行为是什么
当 pyproject.toml 中缺少 dependency-groups.dev 部分时,uv sync 仍会正常运行,但仅安装 dependencies 部分定义的生产依赖。开发依赖不会被识别或安装,除非它们被显式添加到 dependencies 中。这意味着若需管理开发依赖,必须确保配置文件结构完整,否则相关工具链将无法在虚拟环境中可用。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











