Python 包、模块、导入规则

首先：在python中文件夹名不等于包名，文件夹中直接包含__init__.py文件的文件夹才是包，包的核心标识是 __init__.py。

其次：直接运行文件时，仅绝对导入（也就是无 .）生效，相对导入（也就是有 .）必报错；因为直接运行文件的目录就是root目录放在 sys.path中的，如果有相对引用，就会报错。要使用绝对路径。比如a,b是同一个路径下的，运行a, 那么a的路径就是 root，被保存在sys.path中，如果a中导入b中的方法，直接使用绝对路径 from b import B ,就能找到root+b的绝对路径，而不要再添加一个. 号了。如果路径格式如下：

-------p1

| |

| --------a.py

--------p2

-------b.py

python 复制代码

# p/p2/b.py
class B:
    def __init__(self):
        print("我是p2/b.py中的B类")

python 复制代码

# p/p1/a.py
import sys
from pathlib import Path

# 关键：把根目录p/加入sys.path
# Path(__file__) 是a.py的路径 → parent是p1/ → parent.parent是p/
ROOT_PATH = Path(__file__).parent.parent
sys.path.append(str(ROOT_PATH))

# 现在可以用绝对导入p2.b中的B类 因为p/已经在sys.path中了，可以直接看到p2.b
from p2.b import B

if __name__ == "__main__":
    b = B()  # 运行后输出：我是p2/b.py中的B类

其三：相对引用格式： .a 表示当前路径下的a文件，..a 表示上一级路径下的a文件，...a 表示上上一级的a文件。相对引用只能在 sys.path目录之内，不能跨过添加到sys.path的ROOT。

其四：当前运行的文件a, 系统会自动将当前文件路径添加到 sys.path中，Path(file) 是a.py的路径 → parent是p1/ → parent.parent是p/。

其五：还可以将深层的函数向上导出，从而简化导入路径。

在p/p2/init.py中

python 复制代码

#p/p2/__init__.py
from .b import B
__all__=['B']

在p/init.py中

python 复制代码

#p/__init__.py
from .p2 import B
__all__=['B']

这样外部就可以直接用 from p import B了

-------p1

| |

| --------a.py

--------p2

| |

| -------b.py

c.py

小结：

包的本质 ：带 __init__.py 的文件夹才是规范的包（框架开发必加），包内用相对导入（.xxx），外部用绝对导入；
sys.path 是核心 ：Python 只从 sys.path 里找模块，直接运行文件时，文件所在目录会自动加入 sys.path，跨目录导入需手动加根目录；
简化导入的技巧 ：通过多层 __init__.py 逐级导出模块（如 YOLO 的 from ultralytics import YOLO），无需写深层路径；
运行规范 ：包内模块只做定义，可执行逻辑放 tools/ 下的入口脚本，避免直接运行包内文件导致相对导入报错。