使用 uv 只安装生产环境依赖,最推荐的做法是显式指定 --no-dev 参数。该参数会告诉 uv 在解析和安装依赖时,直接忽略 pyproject.toml 中定义的 dev-dependencies 组。执行 uv sync --no-dev 即可在当前环境中仅同步生产所需的包,同时保持开发环境的隔离。

如何验证 uv sync --no-dev 是否生效
要确认 uv sync --no-dev 确实排除了开发依赖,可以检查当前环境的已安装包列表。运行 uv pip list 或查看 uv.lock 文件中的实际安装状态。如果配置正确,列表中不应包含 pytest、mypy 等仅在 [tool.uv.dev-dependencies] 中声明的包。

import subprocess
import sys
# 模拟一个包含 dev-dependencies 的项目结构
# pyproject.toml:
# [project]
# name = "myapp"
# version = "0.1.0"
# dependencies = ["requests"]
#
# [tool.uv.dev-dependencies]
# dev = ["pytest", "black"]
# 执行 uv sync --no-dev
result = subprocess.run(
[sys.executable, "-m", "uv", "sync", "--no-dev"],
capture_output=True,
text=True
)
print("Return Code:", result.returncode)
print("Stdout:", result.stdout)
print("Stderr:", result.stderr)
# 验证:检查 requests 是否安装,而 pytest 未安装
import importlib.util
print("requests installed:", importlib.util.find_spec("requests") is not None)
print("pytest installed:", importlib.util.find_spec("pytest") is not None)
预期结果:
1. returncode 为 0。
2. requests installed 为 True。
3. pytest installed 为 False。
立即学习“Python免费学习笔记(深入)”;
如何在 CI/CD 流水线中应用此策略
在持续集成(CI/CD)环境中,通常只需要运行测试和生产构建,不需要完整的开发工具链。因此,在 CI 步骤中使用 uv sync --no-dev 可以显著加快依赖安装速度并减少磁盘占用。例如,在 GitHub Actions 中,可以在安装依赖的步骤后添加 --no-dev 标志,确保环境精简。

# .github/workflows/ci.yml 示例片段 - name: Install production dependencies run: uv sync --no-dev - name: Run tests run: uv run pytest - name: Build package run: uv build
预期结果:
1. uv sync --no-dev 快速完成生产依赖安装。
2. uv run pytest 能够成功运行,因为 uv run 会自动处理临时环境或基于现有环境的依赖解析,即使 pytest 不在主环境中,它也能通过 uv 的临时解析机制找到并运行它(前提是 pyproject.toml 中定义了 dev-dependencies)。
3. uv build 生成不包含开发依赖的分发文件。
当 pyproject.toml 中没有明确区分 dev-dependencies 时会发生什么
如果 pyproject.toml 文件中没有定义 [tool.uv.dev-dependencies] 部分,那么 uv sync --no-dev 的行为将与 uv sync 完全一致。因为不存在需要排除的开发依赖,所有列出的 dependencies 都将被视为生产依赖。在这种情况下,使用 --no-dev 不会产生任何差异,但也不会报错。开发者应确保在项目初始化时正确划分依赖组,以充分利用 uv 的这一特性。


















