直接运行含相对导入的子模块必然报错，因python未将其识别为包内模块导致__package__为none；必须用python -m以包方式启动，并确保项目为单根包结构。
直接运行含相对导入的子模块必然报错，这不是代码写错了，而是执行方式违反了Python包机制。 你看到的 ImportError: attempted relative import beyond top-level package 或 ImportError: attempted relative import with no known parent package，本质是 Python 没把你的目录当“包”来加载——它压根没识别出父级命名空间。
为什么 python mypackage/submodule.py 一定失败
相对导入（如 from ..utils import helper）不是靠文件系统路径推算的，而是依赖运行时的 __package__ 属性和模块加载上下文。当你执行 python mypackage/submodule.py，Python 把 submodule.py 当作顶层脚本（__name__ == '__main__'），__package__ 为 None，此时任何 . 或 .. 都无从解析。
- 即使所有目录都有
__init__.py，也无效 - IDE 点绿色三角运行，底层往往也是等价于
python xxx.py，同样失败 - 错误不是“找不到文件”，而是“没有包上下文”，所以改
sys.path也没用
必须用 python -m 启动，且包结构要单根
只有通过 -m 参数启动，Python 才会按包路径解析模块，并设置正确的 __package__。但前提是你的项目必须是一个逻辑清晰的“单根包”：所有子包都挂在一个共同的顶层包名下，不能是平级多个包。
- 错误结构（平级包）：
project/ ├── api/ │ └── __init__.py └── core/ └── __init__.py→api和core是两个独立顶层包，from ..core import x必然越界 - 正确结构（单根包）：
project/ └── myapp/ ├── __init__.py ├── api/ │ └── __init__.py └── core/ └── __init__.py→ 此时myapp.api和myapp.core同属myapp包，from ..core import x才有意义 - 启动命令必须是：
python -m myapp.api.main（在project/目录下执行）
包内模块间引用，一律用显式相对导入
一旦结构合规、启动方式正确，包内部的模块通信就该放弃绝对导入，改用 . 和 ..。这是可读性、可移植性和 PEP 328 的硬性要求。
- 同级模块：
from .utils import load_config（.表示当前包） - 上一级包中的模块：
from ..config import settings（..表示父包） - 禁止写
from utils import load_config—— 这是绝对导入，会去sys.path顶层找，不是你本意 -
__init__.py里可以 re-export：from .submod import func，然后外部用from myapp.api import func
调试时快速验证包上下文是否就位
在出问题的模块开头加两行，运行 python -m your_package.module 看输出：
import sys
print(f"__name__: {__name__}")
print(f"__package__: {__package__}")
print(f"sys.path[0]: {sys.path[0]}")
理想输出应类似：
__name__: __main__ __package__: your_package.module sys.path[0]: /path/to/your_project
如果 __package__ 是 None 或空字符串，说明没走 -m，或者根包名没被识别（比如你漏了根目录下的 __init__.py，或当前工作目录不在项目根下）。
最易被忽略的一点：相对导入不是“路径操作”，它是“命名空间操作”。你写的每个 . 都对应一个包层级，而这个层级必须由 -m 和物理目录结构共同定义——少一个环节，整个链就断了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
