当 python 脚本位于多层子目录中并尝试导入同包内其他模块时，因模块搜索路径（sys.path）未包含顶层包根目录，常导致 modulenotfounderror；解决核心是显式配置 pythonpath 或采用包式运行方式。
当 python 脚本位于多层子目录中并尝试导入同包内其他模块时，因模块搜索路径（sys.path）未包含顶层包根目录，常导致 modulenotfounderror；解决核心是显式配置 pythonpath 或采用包式运行方式。
在嵌套包结构（如 foo/bar/burp/cache.py）中直接执行脚本时，Python 默认仅将脚本所在目录（即 foo/bar/burp/）加入 sys.path，而不会向上追溯至包根目录 foo/。因此，from bar.pyro import explosion 中的 bar 无法被识别为合法包——因为 bar 实际位于 foo/bar/，而非当前工作目录下。
而交互式环境中 exec(open(...).read()) 能成功，是因为它绕过了模块导入机制：代码被当作纯文本执行，不触发 import 的路径解析逻辑，所有相对名称（如 bar.pyro）实际依赖的是当前命名空间和手动构造的上下文，并非真正的模块导入，故不具备可移植性和工程安全性。
✅ 正确解决方案如下：
方案一：设置 PYTHONPATH（推荐用于开发调试）
确保顶层包目录（foo）在模块搜索路径中：
$ cd foo # 切换到 foo 目录（可选，但更清晰） $ PYTHONPATH=. python3 bar/burp/cache.py # 或从任意路径运行： $ PYTHONPATH=/path/to/foo python3 /path/to/foo/bar/burp/cache.py
此时 Python 将 .（即 foo/）加入 sys.path，从而能正确解析 bar.pyro 为 foo.bar.pyro。
立即学习“Python免费学习笔记（深入）”；
方案二：使用 -m 参数以模块方式运行（生产首选）
要求项目为合法 Python 包（含各级 __init__.py，已满足），并在 foo/ 外层执行：
$ cd /path/to/parent-of-foo $ python3 -m foo.bar.burp.cache
⚠️ 注意：此时 cache.py 需移除或重命名 .py 后缀（因其作为模块名不可带扩展名），或改用 if __name__ == "__main__": 模式，并通过 python3 -m foo.bar.burp.cache 触发——但需确保 cache.py 位于 foo/bar/burp/__init__.py 同级且无语法冲突。
方案三：动态修改 sys.path（不推荐，仅作兼容性兜底）
在 cache.py 开头插入：
import sys from pathlib import Path sys.path.insert(0, str(Path(__file__).resolve().parent.parent.parent))
该方式破坏封装性、易出错，应避免在正式项目中使用。
? 关键总结：
-
python script.py是“脚本式执行”，路径基于当前工作目录； -
python -m package.module是“模块式执行”，路径基于PYTHONPATH和安装路径； - 所有
__init__.py文件必须存在（你已满足），否则 Python 不识别为包； - 始终优先使用
PYTHONPATH或-m，而非修改sys.path或依赖exec。
