Python测试依赖声明方法咨询：求最佳实践与PyCharm适配方案

《Python之禅》确实提到「做一件事应该有——且最好只有一种——显而易见的方式」，但Python依赖管理的历史遗留问题导致了多种方案并存。不过目前基于PEP规范的现代工具链已经形成了相对统一的共识，同时也有适配PyCharm的强约束方案，匹配你习惯的Gradle/Maven式明确管理风格：

一、当前通用最佳实践 #

• 统一配置入口：pyproject.toml
  遵循PEP 621标准，将测试依赖定义在[project.optional-dependencies]的test分组下，这是目前官方推荐的统一配置方式：

  [project.optional-dependencies]
  test = [
    "pytest>=7.0",
    "pytest-cov>=4.0",
    "flake8>=6.0"
  ]
  

• 安装测试依赖
  使用pip直接安装包含测试依赖的项目版本：

  pip install .[test]
  

• 简化tox配置
  tox仅负责多环境隔离和测试执行，依赖定义完全复用pyproject.toml的配置，避免重复维护：

  [testenv]
  deps = .[test]
  commands = pytest
  

• 废弃旧方案
  停止使用setup.py的tests_require（已废弃）、纯文本dev-dependencies.txt（无版本锁定能力），如果需要版本锁定，可通过pip-compile从pyproject.toml生成requirements-dev.txt作为辅助。

二、适配PyCharm的强约束方案 #

如果你习惯Gradle/Maven式的强约束管理，PyCharm对现代Python工具链的支持足够满足需求：

• 完全基于pyproject.toml管理
  PyCharm 2022.3及以上版本对PEP 621的支持非常完善，会自动识别optional-dependencies中的test分组，无需额外配置。
• 一键安装测试依赖
  在PyCharm的「Python解释器」界面，点击「+」按钮，搜索本地项目包（选择项目根目录），勾选「安装可选依赖」中的test分组，即可自动安装所有测试依赖。
• 内置测试运行器无缝适配
  测试依赖安装完成后，PyCharm会自动识别pytest等测试框架，直接右键测试用例或目录即可运行，无需手动配置测试路径。
• 版本锁定保障一致性
  使用pip-tools的pip-compile工具从pyproject.toml生成锁定版本的requirements-dev.txt，PyCharm会自动读取该文件的版本约束，确保团队环境一致：

  pip-compile pyproject.toml --extra test --output-file requirements-dev.txt
  

内容的提问来源于stack exchange，提问作者Michael