Qt Creator 5.11.0项目经macdeployqt处理后无法加载求助

我之前在macOS上用Qt 5.11处理旧项目打包时，也碰到过一模一样的情况——本地运行正常，macdeployqt处理后就打不开。结合你的命令和场景，分享几个实用的排查和解决步骤：

• 先抓具体错误信息：别光盯着app图标点，直接用终端运行app里的可执行文件，能看到详细的崩溃/报错原因。打开终端，输入：

  /Users/MY_USERNAME/Downloads/build-MY_PROJECT_NAME-Desktop_Qt_5_11_0_clang_64bit-Release/MY_PROJECT_NAME.app/Contents/MacOS/MY_PROJECT_NAME
  

  大概率会输出“找不到QML模块”“缺失依赖库”这类明确的提示，这是定位问题的关键。

• 修正qmldir参数的路径：你的命令里把qmldir指向了构建输出目录，这是常见误区！macdeployqt需要扫描项目源码中的QML根目录来识别依赖，而不是编译后的build目录。比如你的QML文件都存在/Users/MY_USERNAME/Projects/MY_PROJECT/qml下，那命令应该改成：

  ./macdeployqt /Users/MY_USERNAME/Downloads/build-MY_PROJECT_NAME-Desktop_Qt_5_11_0_clang_64bit-Release/MY_PROJECT_NAME.app -qmldir=/Users/MY_USERNAME/Projects/MY_PROJECT/qml -dmg -verbose=3
  

  5.11版本的macdeployqt对QML路径的识别比较严格，路径错了会直接漏掉QML模块打包。

• 检查依赖库的加载路径：有时候macdeployqt会漏掉部分Qt私有库或第三方依赖，用otool工具查看可执行文件的依赖：

  otool -L /Users/MY_USERNAME/Downloads/build-MY_PROJECT_NAME-Desktop_Qt_5_11_0_clang_64bit-Release/MY_PROJECT_NAME.app/Contents/MacOS/MY_PROJECT_NAME
  

  如果输出里还有指向Qt安装目录（比如/Users/xxx/Qt/5.11.0/clang_64/lib/...）的路径，说明这些库没被正确打包到app里。可以手动用install_name_tool修正路径，或者先清理构建目录重新编译打包。

• 清理构建缓存重新来：旧项目的构建缓存有时候会残留奇怪的依赖，先删掉整个build目录，重新用Qt Creator编译出Release版本，再运行macdeployqt，确保是干净的构建产物。

• 检查可执行文件权限：偶尔会出现打包后可执行文件失去执行权限的情况，给它加权限试试：

  chmod +x /Users/MY_USERNAME/Downloads/build-MY_PROJECT_NAME-Desktop_Qt_5_11_0_clang_64bit-Release/MY_PROJECT_NAME.app/Contents/MacOS/MY_PROJECT_NAME
  

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