为什么Python项目的入口文件习惯叫main.py_遵循社区规范提高可读性
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.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 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，改名后报错才去翻日志，而不是一开始就对齐。