相对导入报错主因是运行方式错误而非语法问题：必须用 python -m package.module 运行，且各级目录需有非空 __init__.py；避免顶层包名与标准库冲突，并通过 print(__name__, __package__) 调试上下文。
相对导入报错，绝大多数情况不是语法写错了，而是运行方式不对——python mymodule.py 直接执行文件时，__name__ 是 "__main__"，Python 会拒绝解析任何相对导入。
相对导入只在模块上下文中生效
Python 要求相对导入必须发生在「作为模块被导入」的场景里，不能作为脚本直接运行。比如：
from .utils import helper # ✅ 在包内被 import 时有效 from ..core import config # ✅ 同样依赖模块上下文
但如果你用 python app/main.py 运行，哪怕目录结构完全正确，也会报 ImportError: attempted relative import with no known parent package。
- ✅ 正确做法：在项目根目录（含
__init__.py）下，用python -m app.main - ❌ 错误做法：进入
app/目录后执行python main.py - ⚠️ 注意：
-m会把当前目录当作顶层包，所以确保当前路径是包的父目录
__init__.py 缺失或为空导致隐式包识别失败
Python 3.3+ 支持 namespace packages，但相对导入仍要求明确的包边界——至少一个非空的 __init__.py（哪怕只写 pass）。
立即学习“Python免费学习笔记（深入）”；
- 如果
app/下没有__init__.py，python -m app.main会报No module named 'app' - 空文件（0 字节）在某些旧版本 Python 中也不被识别为包，建议写一行
__all__ = []或pass - 嵌套子包（如
app/api/v1/）每一级都需有__init__.py，否则from ..v1 import router会失败
顶层包名冲突或路径污染
当你的项目目录名和标准库、已安装包同名（比如叫 json、requests、test），Python 可能优先导入系统包，导致 from . import xxx 找不到预期模块。
- 运行前检查：
python -c "import app; print(app.__file__)"确认加载的是你本地的包 - 临时规避：重命名项目目录（如
myapp替代app） - 长期方案：用虚拟环境隔离，并确保
PYTHONPATH未意外包含其他同名路径
真正卡住人的往往不是点号写多写少，而是没意识到相对导入本质上是个「运行时上下文契约」——它不看文件位置，只认 __package__ 和 __name__ 的值。调试时先 print(__name__, __package__)，比反复改 . 数量更有效。
