本文讲解如何通过相对导入（`from .child import child`）解决 python 项目中因执行方式不同导致的 `importerror` 问题，确保 `python project_name` 和 `python3 -m unittest discover` 使用同一套导入语句且稳定工作。
在 Python 项目中，当生产代码与测试代码分离（如 project_name/ 与 tests/ 并列），且需支持多种入口方式（如直接运行包 python project_name 或执行测试套件 python3 -m unittest discover）时，模块导入极易失效——根本原因在于 __package__ 的值随执行上下文动态变化，导致绝对导入路径失效。
例如，在 project_name/submodule/parent.py 中：
- 若写 from submodule.child import Child：适用于 __main__.py 场景（此时 __package__ == 'submodule'），但测试时因 __package__ == 'project_name.submodule' 而报错；
- 若写 from project_name.submodule.child import Child：测试可通过，但 python project_name 会因未将 project_name 视为顶层包而失败（尤其在未安装或未设 PYTHONPATH 时）。
✅ 正确解法：统一使用显式相对导入
将 parent.py 中的导入语句改为：
# project_name/submodule/parent.py
from .child import Child # ✅ 稳定、简洁、无需关心 __package__ 具体值
class Parent:
def __init__(self):
self.child = Child()
def hello(self):
self.child.hello()为什么有效？
相对导入（. 表示当前包）由 Python 解释器根据模块的 __package__ 自动解析真实路径：
- 当 submodule 作为子包被加载（如 python project_name 启动 __main__.py），__package__ 为 'submodule'，.child → submodule.child；
- 当 submodule 作为 project_name 的子包被导入（如测试中 from project_name import Parent），__package__ 为 'project_name.submodule'，.child → project_name.submodule.child。
→ 无论 __package__ 是 'submodule' 还是 'project_name.submodule'，.child 始终指向同级模块 child.py。
? 调试技巧：快速定位导入问题
在疑似出问题的模块顶部加入诊断语句，运行时即可看清上下文：
# 在 parent.py 或 child.py 开头添加
print(f"Running {__file__}\n __package__={__package__!r}\n __name__={__name__!r}")输出将清晰展示不同执行模式下 __package__ 的差异，是排查导入问题的黄金实践。
⚠️ 注意事项
立即学习“Python免费学习笔记（深入）”；
- 相对导入仅在包内模块中有效（即文件必须位于含 __init__.py 的目录中，且通过 import 或 python -m 方式运行，而非直接 python parent.py）；
- 避免混合使用绝对与相对导入处理同一依赖，保持风格统一；
- 若需跨包导入（如 submodule 导入 project_name.utils），应使用 from ..utils import X（.. 表示上层包），而非硬编码顶层包名。
总结：用 from .module import Name 替代 from package.module import Name，是保障多入口项目导入健壮性的最简、最可靠方案。
