Python相对导入报错E0402：为何A包正常B包报错？

首先明确：from .base import *是同一包内的合法相对导入，只要B被正确识别为package的子包，这个语法完全没问题。出现报错的核心原因是Python或代码检查工具没有把B当成package的子模块来处理，下面分场景说明：

1. 代码运行方式错误，导致B被误判为顶级包 #

如果你直接运行B目录下的脚本（比如python package/B/base.py），或者在代码里手动修改sys.path把package/B添加进去，Python会把B本身当作顶级包。虽然单看from .base import *在这种场景下语法合法，但这破坏了package作为一个整体包的结构——如果后续B里有跨包的相对导入（比如导入A的模块），就会触发E0402错误，甚至连当前的from .base import *也可能被代码检查工具误报。

解决方法： #

• 始终从package的父目录以模块方式运行代码：
  假设你的项目结构是：

  project_root/
      package/
          A/
          B/
          app.py
  

  进入project_root目录后执行：

  python -m package.app
  

  用-m参数运行，Python会自动把project_root加入sys.path，确保package被识别为顶级包，A和B作为子包正常加载。
• 不要手动修改sys.path添加子目录（比如package/B），在app.py里导入B的模块时，用绝对导入或同级相对导入：

  # 绝对导入（推荐）
  from package.B import base
  # 同级相对导入（因为app.py在package目录下）
  from .B import base
  

2. 代码检查工具（如pylint）的配置问题 #

如果代码运行正常，但pylint报E0402，那大概率是检查工具没正确识别你的项目包结构：

• 你的IDE（比如VS Code、PyCharm）不小心把B目录标记成了源代码根目录，导致pylint认为B是顶级包；
• pylint没有把package的父目录设置为项目根目录。

解决方法： #

针对VS Code：

• 打开设置，搜索python.analysis.extraPaths，确保添加的是package的父目录，而非package/B；
• 右键点击package目录，选择「将目录标记为源代码根」，让pylint把package当作顶级包识别。

针对pylint命令行：

在项目根目录创建.pylintrc配置文件，添加以下内容指定项目根路径：

[MASTER]
init-hook='import sys; sys.path.insert(0, "./")'

这样pylint会自动把项目根目录加入sys.path，正确识别package的包结构。

3. 确认package目录的__init__.py有效 #

虽然你的目录结构显示package有__init__.py，但如果这个文件存在语法错误或被意外删除，可能导致Python无法识别package作为一个包。不过既然A的导入正常，这个可能性较低，还是可以快速检查一下该文件的完整性。

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