Python导入项目内子目录模块时报错‘No module named A’求助

Python执行脚本时的模块搜索逻辑，默认会把当前直接运行的脚本所在目录加入到搜索路径sys.path的首位。你现在直接运行Desktop/Project/A/b.py，对应的搜索起点是A文件夹本身，根本没有把上层的Project目录纳入搜索范围，自然识别不到名为A的顶层包，最终触发No module named 'A'报错。

方案1：简化同目录导入逻辑 #

a.py和b.py本来就在同一个目录下，在本地单独调试b.py的场景下，完全不需要带上层包名做冗余导入，直接把b.py里的导入语句替换成：

import a

即可正常加载同路径下的a.py模块。

注意：该写法仅适配单独运行b.py的场景，如果后续需要从Project目录下的其他脚本跨路径调用b.py，原有导入逻辑会失效。

方案2：动态适配路径保留原有导入写法 #

如果希望保留你原本写的import A.a as a导入语句，同时适配多场景运行需求，可以在b.py的最开头基于当前文件位置动态定位项目根目录，将其加入模块搜索路径：

import sys
from pathlib import Path

# 从b.py的当前位置向上回溯两级，定位到Project项目根目录
project_root = Path(__file__).resolve().parent.parent
# 将根目录追加到Python的模块搜索路径列表
sys.path.append(str(project_root))

# 原有导入语句即可正常执行
import A.a as a

该写法没有硬编码项目的绝对路径，哪怕后续将整个Project文件夹迁移到其他位置、更换运行环境，导入逻辑也不会失效。

方案3：规范包结构改造（适合长期迭代的项目） #

当项目功能逐步扩展时，推荐用标准Python包结构规范组织代码，改造步骤：

• 在Project、A、B、C四个文件夹下各新建一个空的__init__.py文件，标记这些目录为Python可识别的标准包
• 所有项目运行操作都在Project根目录下执行，不要直接cd进入子文件夹运行单脚本
• 启动b.py时使用模块运行命令，而非直接执行脚本：

  python -m A.b
  

  这种运行方式下，Python会自动把当前工作目录（即Project根目录）纳入搜索路径，你原本写的import A.a as a可以直接正常运行，不需要额外添加路径处理代码。

• 不要在单独运行的脚本里使用相对导入（比如from . import a），否则会触发attempted relative import with no known parent package报错，相对导入仅适用于包内模块被外部调用的场景
• 不要把硬编码的绝对路径加入sys.path，更换设备、迁移项目位置就会直接导致导入失效，优先用pathlib基于当前文件位置动态计算项目路径

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