Python导入树顶层模块的位置与定义方式，多文件导入报错求助

一、为什么from package.folder_a.b import hello会报错？ #

当你直接运行a.py时，Python会把**a.py所在的目录（也就是\package）**添加到模块搜索路径sys.path的最前面。此时package并不是一个可被搜索的模块——因为\package本身就是当前搜索路径的顶层目录，Python会直接在这个目录下查找folder_a，而不是去寻找名为package的子目录。

举个实际场景：如果你在\package目录下执行python a.py，sys.path的第一个元素就是\package，Python会认为该目录下的所有文件夹（folder_a、folder_b）和文件都是顶层模块，所以package这个名称在搜索路径里不存在，自然会抛出ModuleNotFoundError。

二、复杂结构中c.py导入失败的原因 #

当你直接运行c.py时，Python会把\package\folder_b添加到sys.path的最前面。这时候：

• 用from package.folder_a.b import hello：package不在当前搜索路径范围内，无法找到；
• 用from folder_a.b import hello：folder_a在\package目录下，而当前搜索路径是\package\folder_b，同样找不到目标目录。

而当你通过a.py导入c.py时，因为a.py运行时sys.path包含\package，c.py会继承这个搜索路径，此时folder_a处于可见范围，导入就能正常工作。

三、如何将\package设为顶层模块，无需在其目录下运行脚本？ #

有三种可靠的解决方法：

1. 修改环境变量PYTHONPATH #

把\package的父目录添加到PYTHONPATH中：

• Windows命令行：

set PYTHONPATH=C:\path\to\parent_of_package

• Linux/macOS终端：

export PYTHONPATH=/path/to/parent_of_package

这样Python会把该父目录加入模块搜索路径，package就会被识别为顶层模块，无论你在哪个目录运行脚本，都可以用from package.folder_a.b import hello这类绝对导入方式。

2. 用-m参数以模块方式运行脚本 #

在\package的父目录下，执行对应脚本的模块命令：
运行a.py：

python -m package.a

运行c.py：

python -m package.folder_b.c

这种方式会让Python把\package的父目录作为顶层搜索路径，package被当作标准模块包，所有内部的绝对导入都会正常生效。

3. 在脚本中手动修改sys.path #

在a.py或c.py的开头添加以下代码：

import sys
import os
# 将package的父目录加入搜索路径
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

这段代码会自动把\package的父目录添加到sys.path中，让package被识别为顶层模块。不过这种方式依赖脚本的位置，不够灵活，推荐优先使用前两种方法。

补充：Python顶层模块的定义 #

Python的顶层模块是指位于sys.path列表中某个目录下的模块/包。当你导入模块时，Python会依次在sys.path的每个目录下查找对应的模块文件或包含__init__.py的包目录。

要让某个目录成为顶层模块的根，只需要把该目录的父目录加入sys.path，这样该目录就会被当作一个顶层包。

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