本文旨在解决python测试依赖管理中普遍存在的混乱局面，并提出一种基于`pyproject.toml`和`[project.optional-dependencies]`的现代最佳实践。通过将测试依赖声明为可选依赖项，并结合`pip`和`tox`等工具进行安装和管理，可以实现清晰、可维护且符合python最新生态标准的依赖管理流程，从而提升项目开发效率和一致性。

Python测试依赖管理概览

在Python项目开发中，管理测试所需的依赖项一直是一个挑战。与J*a生态中Gradle或M*en等工具提供的高度规范化依赖管理方式不同，Python社区曾涌现出多种管理测试依赖的方法，例如通过dev-dependencies.txt文件、setup.py中的extras_require或tests_require、setup.cfg配置，甚至复杂的tox配置等。这种多样性虽然提供了灵活性，但也导致了缺乏统一标准和最佳实践的困境，使得开发者难以选择最“Pythonic”或最现代化的解决方案。

随着Python项目打包和依赖管理工具链的演进，pyproject.toml文件逐渐成为现代Python项目的核心配置标准。它提供了一个集中、声明式的配置方式，用于定义项目元数据、构建系统、依赖项等。在当前的最佳实践中，利用pyproject.toml来管理测试依赖被认为是实现清晰、可维护且符合最新生态标准的首选方法。

声明测试依赖的最佳实践：pyproject.toml

推荐的最佳实践是将测试依赖声明为pyproject.toml文件中的一个“可选依赖项”（optional-dependency）。这种方法不仅清晰地将测试依赖与核心项目依赖分离，也使得这些依赖可以按需安装，避免了不必要的包膨胀。

1. 配置 pyproject.toml

在pyproject.toml文件中，通过[project.optional-dependencies]部分来定义一个名为test的额外依赖组。这个组可以包含所有运行项目测试所需的库，例如pytest和pytest-cov等。

# pyproject.toml 示例
[project]
name = "your_project_name"
version = "0.1.0"
description = "A short description of your project."
requires-python = ">=3.8"
dependencies = [
    # 核心项目依赖
    "requests>=2.28",
    "beautifulsoup4",
]

[project.optional-dependencies]
# 定义一个名为 'test' 的可选依赖组
test = [
    "pytest>=7.0",
    "pytest-cov>=4.0",
    "flake8>=6.0", # 例如，也可以包含代码质量工具
    # 其他测试工具...
]

解释：

• [project] 部分定义了项目的基本元数据和核心运行时依赖。
• [project.optional-dependencies] 部分专门用于定义非核心、按需安装的依赖组。这里的 test 键名可以根据需要自定义，但 test 是一个约定俗成的名称。

2. 安装测试依赖

一旦在pyproject.toml中定义了测试依赖，就可以使用pip工具轻松地在开发环境中安装它们。

Perplexity

Perplexity是一个ChatGPT和谷歌结合的超级工具，可以让你在浏览互联网时提出问题或获得即时摘要

302 查看详情

# 在当前项目目录中，以可编辑模式安装项目及其测试依赖
pip install -e ".[test]"

解释：

• -e .：表示以“可编辑模式”安装当前目录下的项目。这意味着对项目源代码的任何更改都会立即反映在安装中，无需重新安装。这对于开发非常有用。
• [test]：指定要安装的“额外”依赖组。pip会查找pyproject.toml中[project.optional-dependencies]下名为test的列表，并安装其中列出的所有依赖项。

3. 与 tox 集成

tox是一个自动化测试环境工具，它允许你在多个Python版本和依赖配置下运行测试，确保项目的兼容性。将pyproject.toml中的可选依赖与tox结合使用是现代Python项目测试的强大组合。

在tox.ini文件中，可以通过extras配置项指定在测试环境中安装哪个可选依赖组。

# tox.ini 示例
[tox]
min_version = 4.0
env_list = py38, py39, py310, py311

[testenv]
# 指定安装 pyproject.toml 中定义的 'test' 额外依赖组
extras = test
commands =
    pytest --cov=your_project_name --cov-report=term-missing
    flake8 your_project_name tests/

解释：

• [testenv]：定义了所有测试环境的通用配置。
• extras = test：告诉tox在创建每个测试环境时，除了安装项目本身外，还要安装pyproject.toml中test可选依赖组里指定的所有依赖。
• commands：定义了在测试环境中执行的命令，例如运行pytest和flake8。

优势与注意事项

1. 清晰分离： 将测试依赖与核心运行时依赖明确分开，提高了项目配置的可读性和可维护性。
2. 按需安装： 只有在需要运行测试时才安装测试依赖，减少了生产环境或非开发环境的包体积。
3. 符合标准： 采用pyproject.toml是Python社区的现代标准，确保项目与最新工具和生态系统良好集成。
4. 工具友好： 这种声明方式与pip、tox、PyCharm等现代Python工具链无缝协作，提供一致的开发体验。
5. PyCharm 集成： PyCharm等IDE通常能很好地识别pyproject.toml中的依赖声明。当你使用虚拟环境并按照pip install -e ".[test]"的方式安装后，PyCharm会自动识别这些依赖，并提供代码补全、类型检查等功能。

对于现有项目： 如果你的项目尚未迁移到pyproject.toml，或者使用的是较旧的setup.py或setup.cfg，建议逐步迁移。对于复杂的迁移，可以考虑使用像Hatch这样的现代项目管理工具，它能帮助你初始化和管理pyproject.toml项目，并简化依赖管理。

总结

通过采纳pyproject.toml中的[project.optional-dependencies]来声明测试依赖，Python项目能够实现一种高度结构化、可维护且符合现代最佳实践的依赖管理方案。这种方法不仅解决了过去测试依赖管理混乱的问题，也为开发者提供了一个明确、一致的路径，从而提升了开发效率和项目质量。遵循这一实践，你的Python项目将拥有一个健壮且易于管理的测试环境。

以上就是Python测试依赖管理：使用pyproject.toml的最佳实践的详细内容，更多请关注其它相关文章！

# 旧版本  # 房地产seo优化站点  # 河东网站建设报价  # 海外社媒推广网站怎么做  # 关于营销推广方面  # 关键词排名越高得分越高  # 图片seo怎么做  # 宁海网站推广怎么做  # seo公司哪家好用点  # nike运动鞋的视频营销推广方案  # 网络营销推广准备工作  # 互联网  # 这一  # python  # 邮件处理  # 的是  # 显存  # 所需  # 按需  # 是一个  # 可选  # 开发环境  # 虚拟环境  # pycharm  # 工具  # java 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： c++如何使用TBB库进行任务并行_c++ Intel线程构建模块  使用Pandas转换并合并DataFrame：多列映射至统一结构  SteamMachine定价或为699美元 大家想入手吗？  使用CSS更改登录屏幕输入框中PNG图标颜色的策略与局限性  163邮箱网页版入口导航平台 163邮箱网页版登录入口官网导航  如何修改开机登录密码_Windows账户安全设置超详细教程【必学】  taptap防沉迷怎么解除 taptap解除健康系统限制说明【2025最新】  composer的"require-dev"部分是用来做什么的？  QQ邮箱网页版登录入口 QQ邮箱官方在线使用平台  想当下一个《2077》？《心之眼》Steam评价升至"多半好评"  J*a TimerTask文件监控：HashMap状态管理与常见陷阱规避指南  Win10如何清理注册表垃圾 Win10手动清理无效注册表【技巧】  曝R星经典之作开发图 设计简陋但信息密集！  Sublime Text怎么设置垂直标尺_Sublime配置Rulers规范代码长度  Tailwind CSS line-clamp 布局问题解析与修复指南  理解Python模块与全局变量的作用域管理  qq游戏大厅官方下载_qq游戏免费下载安装入口  Yandex官方入口网址 Yandex俄罗斯搜索引擎最新在线地址  如何提高微信支付的安全性_微信支付安全防护与设置建议  FullCalendar 自定义按钮样式定制指南  2025俄罗斯Yandex最新入口 官方网站地址及浏览器下载指南  ArchiveofOurOwn小说阅读-ArchiveofOurOwn同人作品访问链接  学习通网页版官方登录 超星学习通电脑端入口指南  sublime怎么进行远程开发编辑_配置rsub/rmate实现sublime编辑服务器文件  海棠账号登录入口_登录海棠账户同步阅读记录  J*aScript Promise链中如何正确终止后续.then执行并处理错误  蛙漫画网页版全站入口 蛙漫热门作品免费浏览  邮政快递单号查询入口 邮政快递物流信息在线查询入口  QQ官网正版登录链接 QQ在线登录入口最新  c++中为什么推荐使用using替代typedef_c++现代化类型别名  vivo手机互传视频怎么操作_vivo手机互传视频详细传输方法  C++编译期如何执行复杂计算_C++模板元编程(TMP)技巧与应用  PDO预处理语句中冒号的正确处理：区分SQL函数格式与命名占位符  word邮件合并后日期格式不对怎么改_Word邮件合并日期格式修改方法  J*aScript 字符串标签转换：使用正则表达式高效替换  AO3最新可访问网址 Archive of Our Own官方在线入口  4399免费游戏网址入口 4399小游戏免费入口点开即玩  网站内容防复制粘贴的实现策略与局限性  免费抖音短视频入口_抖音网页版短视频免费通道  C++ map遍历方法大全_C++ map迭代器使用总结  MAC怎么安装Homebrew包管理器_MAC为开发者和高级用户安装命令行工具  Python类型检查：优化关联可选属性的Mypy推断策略  菜鸟取件码是什么怎么查 最全查询渠道汇总  小红书商家版怎样在笔记嵌入商品卡路径_小红书商家版在笔记嵌入商品卡路径【挂载教程】  PyTorch模型训练效果不佳？深入剖析常见错误与调试技巧  yandex入口引擎手机版 yandex安卓版下载入口  win11专注助手在哪 Win11免打扰模式设置与自动化规则【指南】  优化Log4j2控制台输出性能：解决异步日志瓶颈  C++如何使用AddressSanitizer(ASan)_C++调试工具中检测内存访问错误的利器  微博网页版官方账号登录 微博网页版内容浏览使用指南