main.py是python项目约定俗成的入口文件名，非语言强制但保障协作与工具链一致性；它解决python -m执行、自动化工具识别及新人直觉启动问题，与if name == '__main__':协同实现安全可导入的主逻辑封装。
Python项目没有强制入口文件名，main.py 是约定俗成的选择，不是语言要求，但忽略它容易让协作者或部署工具“找不到起点”。
为什么不是其他名字，比如 run.py 或 start.py
这些名字在局部项目里能跑通，但会破坏两个关键预期：
-
python -m模式下无法直接执行：比如python -m mypackage要求包内有__main__.py，而外部入口若叫run.py，就和模块导入体系脱节 - 自动化工具（如 Poetry、PDM、某些 CI 脚本）默认查找
main.py作为可执行入口；换成别的名，就得额外配scripts或entry-points - 新成员 clone 项目后第一反应是
python main.py—— 这个直觉依赖命名一致性，而不是文档提醒
main.py 和 if __name__ == '__main__': 的关系
二者常一起出现，但职责不同：main.py 是文件级入口定位，if __name__ == '__main__': 是模块级执行控制。容易混淆的点：
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 哪怕你把入口文件命名为
app.py，只要里面写了if __name__ == '__main__':，它依然能被直接运行——但别人得先猜到它是入口 - 如果
main.py里没写if __name__ == '__main__':，而是把逻辑全放在顶层，那它被import时就会意外执行（比如触发爬虫请求、删库等副作用） - 推荐结构：把主逻辑封装进
def main():，再用if __name__ == '__main__': main()包一层——这样既支持直接运行，也方便被测试模块干净地导入调用
哪些情况可以不用 main.py
不是所有项目都需要它，绕开的前提是明确替代方案：
- 纯库项目（只提供
import接口）：不需要入口文件，连main.py都不该存在 - CLI 工具用
setuptools或poetry配了console_scripts：入口由函数注册，main.py可以删掉或仅作开发调试用 - Web 服务（Flask/FastAPI）：通常靠
app.run()或 ASGI server 启动，入口常是app.py或server.py，这时强行叫main.py反而模糊语义 - 包内已有
__main__.py：比如你想python -m mypkg启动，那main.py就多余了，优先走包机制
真正容易被忽略的，是文件名和执行方式的耦合性——main.py 不是“必须”，但一旦团队或工具链默认它，临时换名就会卡在最意想不到的地方，比如某行 CI 脚本里的 python main.py --test，改名后报错才去翻日志，而不是一开始就对齐。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
