导入自定义Python包出现KeyError 导入行为不一致问题咨询

报错核心逻辑 #

你遇到的KeyError: 'extra'本质是Python加载完顶层extra包后，找不到其下的子包模块，无法绑定子包属性到extra模块对象上导致的。

差异点排查 #

• 最常见的原因是extra/good、extra/good/best子目录缺少__init__.py文件。Python要将普通文件夹识别为可导入的子包，要求目录下必须存在__init__.py文件（Python 3.3+ 命名空间包场景除外，常规学习场景都需要显式创建）。你能正常导入extra.iota，说明extra根目录已经有__init__.py，但下层子目录大概率缺失该文件。
• 第二个可能是相对路径解析错误：你当前执行脚本的工作目录和预期不符，..\\packages拼接后没有正确指向存放extra包的C:\Users\Luke\py\packages路径，导致Python搜索不到深层子包。

调试方案 #

1. 检查目录结构：确认extra、extra/good、extra/good/best三个目录下都存在空白的__init__.py文件，缺失则新建对应文件。
2. 替换相对路径为绝对路径测试，避免工作目录干扰：将path.append('..\\packages')改为path.append(r'C:\Users\Luke\py\packages')，再运行报错代码验证是否正常。
3. 确认路径生效：在path.append代码后新增print([p for p in path if 'packages' in p])，检查目标包路径确实被加入了Python的模块搜索列表。
4. 排查模块缓存冲突：如果前面步骤都正常仍报错，可在导入代码前新增import sys; print('extra' in sys.modules)，如果输出为True说明之前导入失败有缓存残留，重启Python解释器再运行即可。

内容的提问来源于stack exchange，提问作者luke.morgan.pg