Python pdb调试nmt.py报相对导入无已知父包错误如何解决

普通模式运行正常、python -m pdb nmt.py调试模式触发相对导入报错，核心差异是两种启动方式下Python对脚本的包身份识别逻辑不同：

• 日常正常运行时，代码是按包模块规则加载nmt.py，Python能正确识别它所属的父包上下文，因此from . import inference这类相对导入可以正常解析
• 直接执行python -m pdb nmt.py时，Python会把传入的nmt.py当作独立的顶层脚本加载，不会将它所在的目录识别为合法Python包，没有对应的父包上下文，相对导入自然会抛出ImportError: attempted relative import with no known parent package错误，这个行为符合Python 3.7+的导入规则，和pdb本身逻辑无关。

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

• 优先使用模块模式启动调试：切换到项目根目录（即平时导入项目自定义包时所在的上层目录），将启动命令改为python -m pdb -m 你的项目包名.nmt。举个例子，如果nmt.py存放在名为seq2seq的项目包目录下，对应命令就是python -m pdb -m seq2seq.nmt。这种启动方式和正常运行代码时的模块加载逻辑完全一致，不会破坏原有导入规则，不需要修改任何业务代码。
• 临时指定环境变量启动：如果不方便切换工作目录，可以在启动命令前临时将项目根目录加入PYTHONPATH，再用模块模式启动调试：
  • Linux/macOS 环境执行：PYTHONPATH=/你的/项目/根目录/绝对路径 python -m pdb -m 你的项目包名.nmt
  • Windows cmd 环境执行：set PYTHONPATH=D:\你的\项目\根目录\绝对路径 && python -m pdb -m 你的项目包名.nmt
• 应急调试方案：如果只是临时快速调测，可以把触发报错的相对导入临时改成绝对导入，把from . import inference替换为from 你的项目包名 import inference即可。注意这种方式会降低包的可移植性，不建议作为长期修改提交到代码库。

避坑提示：不要在nmt.py所在的包目录内部，直接执行python -m pdb nmt.py这类把脚本文件作为直接入参的调试命令，这种启动方式下Python永远会把脚本识别为顶层独立文件，无论怎么修改sys.path都容易出现包识别冲突、导入异常的问题。

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