本文详解如何在 Python 包中正确导入并调用定义在 __init__.py 中的函数，避免常见的 NameError 错误，并说明三种标准导入方式的适用场景与注意事项。
本文详解如何在 python 包中正确导入并调用定义在 `__init__.py` 中的函数，避免常见的 `nameerror` 错误，并说明三种标准导入方式的适用场景与注意事项。
在 Python 项目中，常通过创建子目录（如 module1/）并添加 __init__.py 文件将其组织为一个包。若你在 module1/__init__.py 中定义了函数（例如 print_hello()），并期望在 main.py 中直接调用，却遇到 NameError: name ‘print_hello’ is not defined，这并非语法错误，而是对 Python 导入机制的常见误解。
关键在于：import module1 仅导入模块对象本身，不会自动将其中的函数或变量“提升”到当前命名空间 。Python 坚持显式优于隐式的设计哲学，因此必须明确指定要使用的名称。
✅ 正确做法一：模块限定调用（推荐）
# main.py import module1 module1.print_hello() # ✅ 正确：通过模块名访问 输出：
Init loaded Hello✅ 优点：命名清晰、避免命名冲突、便于追踪来源；
⚠️ 注意：需确保 module1/__init__.py 中已正确定义函数且无语法错误（如缩进、拼写）。
✅ 正确做法二：显式导入指定名称
# main.py from module1 import print_hello print_hello() # ✅ 正确：函数已导入至当前作用域 ✅ 优点：调用简洁，适合少量高频使用的函数；
⚠️ 注意：若 print_hello 未在 __init__.py 的 __all__ 列表中（如本例已声明），虽仍可导入，但 from module1 import * 将受限——__all__ 是显式导出白名单，用于控制 import * 行为。
✅ 正确做法三：通配符导入（不推荐用于生产）
# main.py from module1 import * print_hello() # ✅ 可运行（因 __all__ = ["print_hello"]）⚠️ 风险：污染命名空间、降低可读性、引发隐式依赖、难以调试冲突；
? 提示：__all__ 仅影响 from … import *，对 import module1 或 from … import name 无约束作用。
? 补充验证：检查模块内容
可在 main.py 中添加调试代码确认函数是否可用：
立即学习 “Python 免费学习笔记（深入）”；
import module1 print(dir(module1)) # 查看 module1 暴露的所有属性 print(hasattr(module1, 'print_hello')) # 输出 True? 总结建议
- 首选 import module1 + module1.func()：结构清晰、可维护性强，符合 PEP 8 与工程实践；
- 避免 import *，尤其在大型项目中；
- __all__ 不是必需项，但强烈建议显式声明，以明确包的公共接口；
- 确保 __init__.py 文件位于正确路径，且 main.py 与 module1/ 处于同一层级（即 module1 是可导入的顶层包）。
遵循以上原则，即可稳健地在包初始化文件中封装和复用逻辑，充分发挥 Python 包机制的优势。
