Qt Windows调试版本部署：windeployqt未复制全部DLL问题

我之前维护老Qt项目时也碰到过几乎一模一样的问题，结合你用的Qt 5.10 + Qt Creator 4.5.0 + Win10的场景，给你几个实用的排查和解决方向：

1. 检查自动依赖复制配置是否覆盖Debug版本 #

你之前用的自动复制依赖方案，大概率是在.pro文件里加了windeployqt相关脚本。先排查配置是不是只对Release版本生效：

• 打开项目的.pro文件，看看有没有类似这样的条件判断：

  CONFIG(release, debug|release) {
      # 仅在Release下执行部署脚本
      windeployqt.exe $$OUT_PWD/$$TARGET.exe
  }
  

  如果是这样，Debug版本完全没触发自动复制，自然会缺DLL。你可以去掉条件，或者给Debug版本单独加分支：

  CONFIG(release, debug|release) {
      windeployqt.exe $$OUT_PWD/$$TARGET.exe
  }
  CONFIG(debug, debug|release) {
      windeployqt.exe --debug $$OUT_PWD/$$TARGET.exe
  }
  

  注意Debug模式下必须加--debug参数，不然windeployqt会默认复制Release版本的DLL，这是很多人踩过的坑。

2. 精准定位缺失的Debug DLL #

手动复制后能正常运行，说明你已经知道核心依赖，但可以用工具彻底排查所有依赖，避免后续遗漏：

• 用Visual Studio自带的dumpbin工具，打开VS命令提示符，执行：

  dumpbin /dependents 你的Debug版本EXE完整路径
  

  这个命令会列出EXE所有依赖的DLL，对比你手动复制后的部署文件夹，就能找出自动复制脚本没覆盖到的文件。比如Qt的Debug版DLL都是带d后缀的（如Qt5Cored.dll、Qt5Guid.dll），还有平台插件platforms/qwindowsd.dll，如果你的图标用了SVG格式，可能还需要Qt5Svgd.dll。

3. 检查Qt Creator的Debug构建部署步骤 #

有时候项目配置会被误改，导致Debug模式没启用部署：

• 打开Qt Creator，切换到项目视图，选择Debug构建套件，查看构建步骤里有没有添加Deploy环节；
• 如果用windeployqt作为部署工具，确认参数里加了--debug，且目标路径指向的是Debug版本的EXE。

4. 排除图标资源本身的加载问题 #

如果缺失的DLL都补全了还是有图标问题，要排查资源加载逻辑：

• 如果你是用.qrc资源文件嵌入图标，确认.pro文件里已经添加RESOURCES += 你的资源文件.qrc，并且Debug构建时资源文件被正常编译（可以看构建输出里有没有rcc相关的执行命令）；
• 如果是外部图标文件，要确保这些文件也被复制到Debug部署目录，或者代码里的文件路径是正确的相对路径。

内容的提问来源于stack exchange，提问作者Sven Arno Jopen