本文详解如何在 python 包中使用相对导入（如 from .connector1 import connector1）让同级子模块（如 connector2）安全、清晰地引用兄弟模块（如 connector1），避免硬编码包名，提升可移植性与维护性。
本文详解如何在 python 包中使用相对导入（如 from .connector1 import connector1）让同级子模块（如 connector2）安全、清晰地引用兄弟模块（如 connector1），避免硬编码包名，提升可移植性与维护性。
在构建可复用的 Python 库时，合理的模块组织与导入方式至关重要。你提供的目录结构是一个典型的分层包设计：
Tools/
__init__.py
connector1/
__init__.py
connector1.py
connector2/
__init__.py
connector2.py此时，若希望 connector2/connector2.py 使用 connector1 中定义的功能，不应依赖绝对导入路径（如 from Tools.connector1 import connector1）——该写法在开发阶段可能因执行上下文（如直接运行 .py 文件）而失败，且耦合了顶层包名，不利于重构或嵌套部署。
✅ 正确做法是使用 显式相对导入（Explicit Relative Imports）：
# 在 connector2/connector2.py 中 from .connector1 import connector1 # ✅ 导入同级子包 connector1 # 或导入整个模块 from . import connector1 # 然后使用 connector1.connector1
这里的 . 表示“当前包”（即 Tools），因此 .connector1 等价于 Tools.connector1。同理：
立即学习“Python免费学习笔记（深入）”；
- .. 表示父包（若存在多层嵌套）；
- ...module_name 表示上两级包中的模块。
⚠️ 关键前提与注意事项：
- 所有目录必须包含有效的 __init__.py（可为空），以被 Python 识别为包；
- 相对导入只能在包内模块中使用，不可在直接执行的脚本（如 python connector2.py）中运行——否则会报 SystemError: Parent module 'connector2' not loaded, cannot perform relative import；
- 推荐通过 -m 参数以模块方式运行：
python -m Tools.connector2 # ✅ 正确：Python 将 Tools 视为顶级包
- 若需从外部导入（如主程序调用），应在 Tools/__init__.py 中显式暴露接口，例如：
# Tools/__init__.py from .connector1 import connector1 from .connector2 import connector2 __all__ = ["connector1", "connector2"]
这样用户可简洁使用 from Tools import connector1。
? 总结：相对导入是构建健壮 Python 包的核心实践。它解耦模块路径、增强封装性，并与 PEP 328 设计原则一致。务必确保包结构合规、执行方式正确，并善用 __init__.py 控制公共 API——这既是 Pandas 等成熟库的做法，也是你迈向专业库开发的关键一步。
