Flask项目tests目录导入modules模块触发导入报错问题咨询

这个导入异常和Flask框架没有任何关联，完全是Python原生的模块搜索路径机制导致的。
你提到Python 3.3+无需__init__.py即可识别包的描述是正确的，但这个特性生效的前提是：包所在的根目录必须在Python的模块搜索路径列表sys.path中，路径配置错误时无论有没有__init__.py、用不用Flask，都会出现导入失败。

报错原因拆解 #

• 你运行app.py时，执行命令的工作目录是Application/根目录，Python会自动把当前工作目录加入sys.path，因此from modules.xxx import xxx的绝对导入可以正常找到对应模块。
• 你运行tests/下的测试文件时，如果是在tests/目录内直接执行脚本，或是IDE/测试工具的工作目录没有指向Application/根目录，Python的搜索路径里就没有Application/，自然找不到顶层的modules包，触发ModuleNotFoundError。
• 相对导入报错是因为：直接运行单个测试脚本时，这个脚本会被Python识别为顶层入口模块，不属于任何父包层级，自然无法使用./..的相对导入语法跨层级引用模块，这个问题在所有Python项目中都会出现，和Flask无关。

按推荐优先级从高到低排列：

• 从项目根目录执行测试（最符合Python项目规范）
  运行测试时始终先切换到Application/根目录，再执行pytest命令，不要进入tests/目录内运行测试。pytest默认会将执行命令时的工作目录加入sys.path，此时测试文件中写from modules.classes import Round, Class这类从根目录开始的绝对导入即可正常运行。如果使用IDE运行测试，将测试配置的工作目录手动指定为Application/根目录即可。
• 动态注入项目根路径（适合临时调试，无侵入）
  如果需要在任意路径下都能正常运行测试文件，可以在测试文件的最顶部（所有导入modules的语句之前）添加如下代码，手动将项目根目录加入搜索路径：

  import sys
  from pathlib import Path
  # 测试文件位于Application/tests/下，parent.parent就是Application根目录
  project_root = Path(__file__).parent.parent.resolve()
  sys.path.insert(0, str(project_root))
  

• 显式标记包（结构最稳定）
  虽然隐式命名空间包不需要__init__.py，但常规项目建议在modules/、tests/目录下各创建一个空的__init__.py文件，将两个目录标记为显式Python包，配合从根目录运行测试的方式，可以避免绝大多数路径识别导致的导入异常。

注意：不要在测试文件中使用相对导入尝试引用上级目录的modules，只要测试文件作为顶层入口运行，相对导入必然触发"attempted relative import with no known parent package"报错，测试文件统一使用从项目根目录开始的绝对导入即可。不要为了解决导入问题将项目文件复制到全局Python的site-packages目录，会污染全局环境。

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