必须用绝对导入当模块不在当前包结构内或脚本独立运行时，因相对导入依赖__package__属性且仅在包内导入有效；应统一用绝对导入并确保包根在sys.path中。
什么时候必须用绝对导入
当模块不在当前包结构内、或你正在写可独立运行的脚本（比如 python myscript.py）时，绝对导入是唯一可靠的选择。Python 的 __name__ 在直接运行时是 '__main__'，此时相对导入会报 ImportError: attempted relative import with no known parent package。
常见踩坑场景：
- 把包内模块当成脚本单独执行（如
python pkg/submod.py） - 使用
-m但没从包根目录运行（如在pkg/目录下执行python -m submod） - 测试文件（
test_*.py）未被识别为包的一部分，却写了from .utils import helper
解决办法：一律用绝对导入，从包根开始写路径，例如 from myproject.pkg.utils import helper，并确保 myproject 在 sys.path 中（常用 pip install -e . 或临时加 sys.path.insert(0, '/path/to/myproject')）。
相对导入只在包内模块间协作时有效
相对导入本质是基于当前模块的 __package__ 做路径解析，它只在模块被 Python 作为包成员导入时才工作，比如 python -m myproject.pkg.main。
关键约束：
- 当前文件必须有
__package__属性（即不能是__main__） - 导入语句只能出现在模块顶层，不能在函数或条件块里
-
.表示同级，..表示上一级，不能越界（如...foo在顶层包里会失败）
示例：假设结构是 myproject/pkg/a.py 和 myproject/pkg/b.py，想在 a.py 中导入 b.py，应写 from .b import something；若要导入 myproject/utils.py，且 utils.py 与 pkg 同级，则写 from ..utils import helper（前提是 a.py 是通过 python -m myproject.pkg.a 运行）。
混合使用时优先统一为绝对导入
团队项目中混用两种导入方式会导致可读性下降和 CI 失败——尤其当测试框架（如 pytest）对 __package__ 的处理与你预期不一致时。pytest 默认把测试文件当普通模块加载，此时 from ..src import mod 必然炸。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
更稳妥的做法：
- 所有跨文件引用都走绝对导入，以包名为起点
- 在
pyproject.toml或setup.py中明确定义包名和入口点 - 用
python -m pytest tests/替代python tests/test_mod.py，避免破坏包上下文 - 检查
__init__.py是否存在且非空（空文件也行，但不能缺失）
一个小技巧：在模块开头加 assert __package__, "This module must be imported as part of a package"，提前暴露误用相对导入的问题。
IDE 和 linter 的提示不一定准
PyCharm 或 VS Code 的 Python 插件常根据当前工作目录推测导入路径，可能把合法的绝对导入标成“unresolved reference”，也可能对相对导入过度宽容（比如允许你在 __main__ 里写 from .x import y，运行时才崩）。
真正可靠的判断依据只有两个：
- 运行时的
__package__值（打印看看） - 实际执行命令的路径和方式（
pwd+python -m xxx）
不要依赖编辑器高亮做导入决策。如果不确定，就删掉所有 . 和 ..，改用绝对路径，再确认 sys.path 是否包含包根目录。
最常被忽略的一点：包根目录下没有 __init__.py，或者用了 PEP 561 的 py.typed 却没配好 pyproject.toml，都会让 Python 拒绝识别整个包结构——这时连绝对导入都会失败。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
