使用PyInstaller将Python程序转换为可执行文件时遭遇脚本未找到问题

快速修复步骤 #

• 立刻把你的脚本文件名从MAIN.py改成一个不涉及Python特殊名称的自定义名字，比如my_app_entry.py或者project_main.py。
• 回到CMD的对应目录，重新执行pyinstaller 你的新文件名.py，这时候就能正常识别并打包你的脚本了。

问题根源解析 #

你踩的坑是文件名与Python内部特殊标识冲突：虽然严格来说main不是Python的保留关键字，但它是Python程序入口的核心标识（比如我们常写的if __name__ == '__main__'），同时PyInstaller在打包流程中会对这个名称做特殊逻辑处理。当你用MAIN.py（不管大小写）作为脚本名时，PyInstaller会把它和Python自身的入口逻辑混淆，导致无法正确定位到你的本地脚本，最终抛出"脚本未找到"的错误。

后续避坑建议 #

• 给Python脚本命名时，尽量避开Python的保留关键字（比如def、class、return等），也别用常见的内置模块/特殊标识名（比如sys、os、main、__main__）。
• 命名最好采用小写字母加下划线的风格（比如my_project_entry.py），既符合Python的命名规范，也能最大程度避免这类冲突。

内容的提问来源于stack exchange，提问作者the_he_man