项目结构示例

my_project/
├── main.py
└── package/
    ├── __init__.py
    ├── module_a.py
    └── subpackage/
        ├── __init__.py
        └── module_b.py

优点：

• 清晰明确，易于理解模块来源
• 不受模块位置变化影响
• 更符合PEP8规范
• 可以在项目任何位置直接运行模块

注意事项：

• 相对引用只能在包内部使用（包含__init__.py的目录）
• 不能在顶级脚本中使用（如直接运行的脚本）
• 模块位置变动可能导致引用失效
• 过度使用会降低代码可读性

推荐使用绝对引用的场景：

• 项目的主入口文件（如main.py）
• 跨包的模块引用
• 公共库和框架的开发
• 需要直接运行的脚本

相对引用可能适用的场景：

• 同一包内的紧密耦合模块
• 深层次嵌套的包结构
• 私有模块或内部实现细节
• 重构期间的临时方案

PEP8规范建议：

Python官方风格指南PEP8建议：

"Absolute imports are recommended, as they are usually more readable and tend to be better behaved... Explicit relative imports are an acceptable alternative to absolute imports."

翻译：推荐使用绝对导入，因为它们通常更可读且行为更好...显式相对导入是绝对导入的可接受替代方案。

Q: 为什么我的相对引用会报"ImportError"？

A: 通常是因为：

• 在顶级脚本中使用相对引用（Python不允许）
• 目录结构中没有__init__.py文件
• 相对路径计算错误（使用了过多的..）

Q: 如何将相对引用转换为绝对引用？

A: 转换方法：

# 相对引用
from .. import utils

# 转换为绝对引用
from myproject.package import utils

Q: 绝对引用会不会导致路径过长？

A: 对于深层次嵌套的包，可以使用as关键字创建别名：

from myproject.core.services.data_processing import analytics as da