如何使用py2app构建Tkinter Python应用并解决运行报错问题？

1. 修正打包命令 #

你输入的打包命令存在拼写与格式错误，导致未生成正确的.app包结构：

• 错误命令：python3 setup setupy.py → 正确命令：python3 setup.py py2app
• 错误调试命令：python setup setup.py -A → 正确调试命令：python3 setup.py py2app -A

命令里的setupy.py是笔误，且缺少核心的py2app指令，这才导致dist目录仅生成单个文件，而非完整的.app包结构。

2. 修复setup.py的配置错误 #

你的DATA_FILES中包含了main.py，这是错误操作——APP参数已指定main.py作为应用入口，无需再将其加入数据文件列表，否则可能引发加载冲突。修改后的setup.py如下：

from setuptools import setup
APP = ["main.py"]
OPTIONS = {
    "argv_emulation": True,
    "iconfile": "icon.png"
}
# 移除main.py，仅保留依赖的资源文件
DATA_FILES = ["Cute-Penguin-icon.png", "data.json", "data.txt", "icon.png", "usernames.txt"]

setup(
    app=APP,
    data_files=DATA_FILES,
    options={'py2app': OPTIONS},
    setup_requires=['py2app'],
)

3. 正确执行调试打包与日志获取 #

1. 先清理之前的打包残留文件：

rm -rf build dist

2. 执行调试模式打包：

python3 setup.py py2app -A

3. 此时dist目录会生成main.app（因APP参数为main.py，默认应用名为main），运行以下命令获取错误日志：

./dist/main.app/Contents/MacOS/main

终端会输出详细错误信息，可根据日志定位具体问题（比如资源文件路径错误、Tkinter依赖缺失等）。

4. 额外注意事项 #

• 确保所有资源文件（如icon.png、data.json等）与setup.py、main.py在同一目录下，打包时py2app会自动将这些文件复制到.app包内。
• 若使用M系列Mac，需确保Python环境为原生ARM版本，避免架构不兼容导致运行错误。

内容的提问来源于stack exchange，提问作者felix.machan