macOS版Qt程序不能直接拷.app发布，因macdeployqt仅处理Qt框架，不管理第三方dylib、自定义库及部分插件；需手动补全Frameworks/、PlugIns/、Resources/目录，重写@rpath并签名公证，否则他人机器易闪退或资源异常。
macOS版Qt程序不能直接拷.app就发出去——哪怕macdeployqt跑过了，也极大概率在别人机器上打不开、闪退或图片/字体异常。
为什么macdeployqt经常“看起来成功”却实际失败
它只处理 Qt 自家的 framework（如 QtCore.framework、QtGui.framework），对以下三类东西完全不管：
- 你项目里用到的第三方 dylib（比如
libcurl.dylib、libqxmpp.1.dylib） - 你自己写的动态库（
myplugin.dylib） - Qt 插件目录中缺失的子项（如
platforms/libqcocoa.dylib有时被漏掉，导致白屏）
典型现象是：本地双击能跑，但换台没装 Xcode 的 Mac 就报 Library not loaded: @rpath/xxx.dylib 或直接无响应。根本原因是 dylib 的加载路径（@rpath）没重写，系统还在往 /usr/local/lib 这类全局路径找。
必须手动补全的三个关键位置
运行完 macdeployqt 后，打开 yourApp.app/Contents，重点检查并补漏：
-
Frameworks/目录：把所有第三方 dylib 全部复制进去（不能只放 Qt 的） -
PlugIns/目录：确认platforms/libqcocoa.dylib、imageformats/libqjpeg.dylib等存在；缺哪个就从Qt/5.x/clang_64/plugins/对应子目录拷 -
Resources/目录：QML 项目必须把qml/子目录整个放进来，否则QQmlApplicationEngine加载失败
别信“自动识别”——macdeployqt 不扫描你的 .pro 里 LIBS += -L/path/to/mylib -lmylib，它只看链接时记录的绝对路径（通常是你开发机上的路径），一搬家就断。
重写 dylib 加载路径是硬性步骤
只要用了任何非 Qt 官方的 dylib，就必须用 install_name_tool 改 @rpath。例如：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
install_name_tool -change "/usr/local/lib/libcurl.4.dylib" "@rpath/libcurl.4.dylib" yourApp.app/Contents/MacOS/yourApp
然后确保该 dylib 已放在 yourApp.app/Contents/Frameworks/ 下，并在启动前设置好 rpath：
install_name_tool -add_rpath "@executable_path/../Frameworks" yourApp.app/Contents/MacOS/yourApp
漏掉这步，哪怕 dylib 文件物理存在，系统也找不到——这是 macOS 动态链接机制决定的，和 Windows 的 PATH 完全不同。
签名和公证不是可选项，而是上线 App Store 或 Gatekeeper 通过的强制门槛
从 macOS 10.15（Catalina）起，未签名应用默认被拦截；2026 年绝大多数用户已升级到 macOS 14+，Gatekeeper 对 com.apple.security.cs.disable-library-validation 等绕过手段越来越严格。
- 用开发者证书签名：
codesign --force --deep --sign "Developer ID Application: XXX" yourApp.app - 必须对每个 dylib 单独签：
codesign --force --sign "Developer ID Application: XXX" yourApp.app/Contents/Frameworks/*.dylib - 上传公证（notarization）：
xcrun notarytool submit --key-chain-account "AC_PASSWORD" yourApp.zip --wait
跳过签名 → 用户右键“打开”才能运行；跳过公证 → 即使签名了，首次运行仍弹窗“已损坏”，必须进系统设置里手动允许——这对普通用户等于不可用。
最常被忽略的是：Qt 6.5+ 默认启用 QCocoaIntegration 的新渲染路径，若没带 platforms/libqcocoa.dylib 或签名不完整，会静默崩溃，连 crash report 都不生成。验证务必在干净虚拟机（没装 Xcode、没装 Qt）里做，而不是开发机上点一下就完事。
