崩溃主因是Python链接了macOS废弃的Tk 8.5，需安装匹配版本的python-tk@X.Y并设DYLD_LIBRARY_PATH，打包改用PyInstaller，Retina卡顿则禁用Info.plist中NSHighResolutionCapable。
崩溃通常不是代码问题，而是Python解释器没连上新版Tk——系统自带的Tk 8.5已被Apple弃用，但Python仍会fallback过去，一调用GUI就崩。
检查Tk版本和加载路径是否指向系统旧版
先确认问题根源：运行以下命令，看输出是否暴露系统路径
python3 -c "import tkinter; print(tkinter.TkVersion); import tkinter as tk; root = tk.Tk(); print(tk._default_root.tk.eval('info library'))"如果 TkVersion 是 8.5，且 info library 输出含 /System/Library/Frameworks/Tk.framework/Versions/8.5，说明正在加载废弃系统Tk——这是绝大多数崩溃（空白窗口、NSInternalInconsistencyException、双击.app闪退）的直接原因。
- 不要重装
tcl-tk单独包，Homebrew 的tcl-tk不带 Python 绑定 - 不要用
pip install tkinter，该命令必然失败，因为tkinter不是 PyPI 包 - pyenv 安装 Python 时即使加了
--enable-framework或指定TCLTK_CFLAGS，也不保证运行时链接正确
安装匹配的 python-tk@X.Y 并强制链接
Homebrew 提供的是预编译的、已绑定 Python 解释器的完整 Tkinter 支持包，必须与你当前 Python 版本严格一致（例如 Python 3.10.15 → 必须用 python-tk@3.10）
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
立即学习“Python免费学习笔记（深入）”；
- 查可用版本：
brew search python-tk（输出如python-tk@3.10、python-tk@3.11） - 安装对应包：
brew install python-tk@3.10 - 获取安装路径：
brew --prefix python-tk@3.10（典型为/opt/homebrew/opt/python-tk@3.10） - 在
~/.zshrc中添加环境变量（关键！）：export DYLD_LIBRARY_PATH="/opt/homebrew/opt/python-tk@3.10/lib:$DYLD_LIBRARY_PATH" - 执行
source ~/.zshrc后重启终端，再验证版本
打包后双击崩溃？优先换 PyInstaller，别碰 py2app
py2app 在 macOS 上对 Tkinter 资源路径处理不稳定，尤其涉及 assets、字体或 Toplevel 窗口时，极易触发 NSInternalInconsistencyException。PyInstaller 对 Tkinter 的打包兼容性更好，且能显式控制资源路径
- 安装：
pip install pyinstaller - 打包带资源的脚本：
pyinstaller --onefile --add-data "assets:assets" --icon=app.icns org_chart_min.py - 确保主脚本开头加
import sys, os，并在加载资源前修正路径：base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__))) - 不要依赖
__file__直接拼资源路径，打包后它会失效
Retina 屏卡顿或模糊？改 Info.plist 的 NSHighResolutionCapable
如果应用在 MacBook 内屏明显卡顿、动画掉帧，但外接显示器流畅，大概率是高分屏渲染开销过大。这不是代码问题，而是 macOS 强制启用 HiDPI 渲染所致
- 定位文件：对 Homebrew 安装的 Python，路径通常是
/opt/homebrew/Cellar/python-tk@3.10/8.6.14_1/Resources/Python.app/Contents/Info.plist；对官方安装包，则是/Library/Frameworks/Python.framework/Versions/3.10/Resources/Python.app/Contents/Info.plist - 用
plutil命令修改：sudo plutil -replace NSHighResolutionCapable -bool false /path/to/Info.plist - 修改后必须重建 Python.app 的签名（若系统启用了公证）：
sudo codesign --force --deep --sign - /path/to/Python.app - 注意：设为
false后 UI 会轻微模糊，但换来的是稳定帧率，对多数工具类 GUI 已足够
最易被忽略的一点：所有环境变量（DYLD_LIBRARY_PATH）和 Info.plist 修改，只对新启动的终端/进程生效；已打开的 IDE、Jupyter 或后台 Python 进程不会自动继承，务必重启它们再测试。
