Python中如何正确调用__init__.py内定义的函数

在Python的包结构中，__init__.py文件是包的核心标识文件，开发者常会在这个文件中定义一些包级别公共函数，方便外部直接调用。要正确调用这些函数，需要结合导入规则和包结构来操作，不同场景下的调用方式存在区别。

同包内调用__init__.py定义的函数

当需要在同一个包的其他模块中调用__init__.py里定义的函数时，可以直接使用相对导入或者绝对导入的方式。假设包结构如下：

# 包结构
my_package/
    __init__.py
    utils.py

首先在__init__.py中定义一个测试函数：

# my_package/__init__.py
def package_func():
    return "这是__init__.py中定义的函数"

在utils.py中调用该函数，使用相对导入的写法：

# my_package/utils.py
from . import package_func

result = package_func()
print(result)

也可以使用绝对导入，前提是项目根目录在Python的搜索路径中：

# my_package/utils.py
from my_package import package_func

result = package_func()
print(result)

跨包调用__init__.py定义的函数

当需要在其他包或者项目根目录的脚本中调用__init__.py里的函数时，直接导入包名即可获取到__init__.py中定义的公共对象。假设项目结构如下：

# 项目结构
project/
    main.py
    my_package/
        __init__.py

在main.py中调用my_package包__init__.py里的函数，写法如下：

# project/main.py
import my_package

result = my_package.package_func()
print(result)

也可以先导入具体的函数再使用：

# project/main.py
from my_package import package_func

result = package_func()
print(result)

注意事项

• __init__.py中定义的函数如果没有通过__all__变量声明，默认也可以被外部导入，但规范的做法是在__init__.py中定义__all__明确导出对象：

# my_package/__init__.py
__all__ = ["package_func"]

def package_func():
    return "这是__init__.py中定义的函数"

def _private_func():
    return "这是私有函数，不会被默认导出"

• 如果包的路径没有加入Python的搜索路径，导入时会抛出ModuleNotFoundError错误，可以通过设置PYTHONPATH环境变量或者在代码中动态添加路径解决。
• 避免使用from __init__ import package_func这种写法，不符合Python的包导入规范，正确的写法是通过包名来导入。

常见错误示例

很多新手会尝试直接导入__init__.py文件，这种写法是错误的：

# 错误写法
from my_package.__init__ import package_func  # 不符合规范，不推荐使用

正确的做法始终是通过包名来访问__init__.py中定义的对象，这样符合Python的包管理逻辑，也能避免后续包结构调整时出现导入错误。

Python__init__.py函数调用包管理修改时间：2026-06-27 06:33:14