Python中__init__.py与main.py区别及入口写法

脚本专家

很多Python初学者会把 __init__.py 和 main.py 混在一起理解，实际上两者职责完全不同：__init__.py 属于包机制，决定目录如何被导入；main.py 更像启动脚本，负责把项目跑起来。下面按用途、代码示例、执行时机和常见项目结构来梳理。

一、__init__.py：让目录成为Python包

在包目录中放置 __init__.py，Python 就会把该目录按包处理。典型结构如下：

2. mypackage/
3. ├── __init__.py
4. ├── module_a.py
5. └── module_b.py

复制代码

它主要有三个作用：标识包，告诉Python这个目录应作为package；执行初始化代码，包被导入时自动运行；控制导入，通过 __all__ 简化导入路径。

示例：

2. # mypackage/__init__.py
3. print("mypackage 被导入了")
4. from .module_a import func_a
5. from .module_b import func_b
6. __all__ = ['func_a', 'func_b']

复制代码

使用时可以直接访问包内函数：

2. import mypackage
3. mypackage.func_a()

复制代码

因为 __init__.py 中已经执行了 from .module_a import func_a，所以不必写成 mypackage.module_a.func_a()。__all__ 则决定 from mypackage import * 时导出哪些名字。

从 Python 3.3 开始，__init__.py 对命名空间包来说不是必需的，但实际项目仍推荐保留。原因包括：明确标识包边界、兼容旧版本、在包导入时放置初始化逻辑。

二、main.py：程序入口与流程调度

main.py 通常位于项目根目录，直接通过 python main.py 运行；也可能放在包内，作为命令行入口模块。它负责解析参数、调用各模块、启动服务等流程组织工作。

2. project/
3. ├── main.py
4. ├── utils.py
5. └── mypackage/
6.     └── __init__.py

复制代码

一个常见写法是：

2. # main.py
3. from mypackage import func_a, func_b
4. import argparse
6. def main():
7.     parser = argparse.ArgumentParser()
8.     parser.add_argument("--name", default="world")
9.     args = parser.parse_args()
10.     func_a()
11.     func_b()
12.     print(f"Hello, {args.name}")
14. if __name__ == "__main__":
15.     main()

复制代码

这里 if __name__ == "__main__" 的作用是：只有直接运行 main.py 时才执行 main()；如果 main.py 被其他模块导入，则不会误触发程序流程。

三、两者对比

__init__.py：位于包目录内部；Python 3.3+ 可选但推荐保留；在包被导入时执行；用于标识包、初始化、控制导入；典型内容是 from .x import y 和 __all__；每个包一个。

main.py：通常位于项目根目录，也可放在包内作为入口；不是语法必需，更多是约定；手动运行或命令行调用时执行；用于程序入口和组织流程；典型内容是 if __name__ == "__main__":；项目可以有多个入口脚本。

四、__name__ == "__main__" 的连接作用

这是理解两者的关键概念。__init__.py 中也可以写：

2. # mypackage/__init__.py 里也可以写：
3. if __name__ == "__main__":
4.     print("直接运行 __init__.py")

复制代码

当文件被导入时，__name__ 是模块名，例如 mypackage；当文件被直接运行时，__name__ 是 "__main__"。所以 main.py 常写 if __name__ == "__main__":，保证它作为模块被导入时不执行入口逻辑。

配合关系可以概括为：main.py 导入包，触发 __init__.py，包内模块准备就绪，然后 main.py 调用它们运行程序。

五、常见项目结构

简单脚本结构：

2. project/
3. ├── main.py
4. ├── utils.py
5. └── config.py

复制代码

正规包结构：

2. project/
3. ├── main.py
4. ├── requirements.txt
5. └── mypackage/
6.     ├── __init__.py
7.     ├── core.py
8.     ├── utils.py
9.     └── cli.py

复制代码

如果做成可安装包并带命令行入口，可以在 pyproject.toml 中声明：

2. # pyproject.toml
3. [project.scripts]
4. myapp = "mypackage.main:main"

复制代码

此时 mypackage/main.py 就是包内的入口模块，main 函数作为命令入口被调用。

一句话总结：__init__.py 让目录成为包，并控制导入行为；main.py 是程序入口，负责启动和调度。两者不是替代关系，而是入口脚本与包初始化机制之间的配合关系。