VS2019 clang-cl搭配VS2017编译的QT5 Release版链接报错问题

报错直接原因 #

lld-link : error : unknown file type: .obj\release\qaxobject.obj 错误本质是链接器无法识别目标文件的二进制格式，绝大多数情况是不同编译链/不同编译配置生成的目标文件ABI不匹配导致的。

Debug正常、Release异常的原因 #

• Clang-cl的二进制兼容是同大版本VS、同编译配置维度的兼容，不是跨所有VS版本所有配置的全兼容：VS2019自带的clang-cl默认会适配同版本MSVC的Release编译参数，和VS2017编译的Qt Release库的生成规则存在差异，Debug模式下编译链的ABI校验规则更宽松、且Qt Debug库本身携带的冗余调试信息会掩盖部分格式差异，所以不会触发报错。
• Qt的ActiveQt模块（也就是qaxobject.obj所属的模块）对编译参数的敏感度远高于普通Qt模块，Release模式下开启的O2优化、整函数链接、COFF格式裁剪等参数，会放大两个版本编译链生成的目标文件的格式差异，直接触发lld-link的格式校验失败。

Qt官方对Windows平台clang-cl的支持说明 #

Qt 5.15及后续的所有Qt 6版本，官方正式支持Windows平台用clang-cl编译，但要求编译Qt本身的编译链版本和编译应用的clang-cl版本严格匹配：

• 如果你用VS2017的MSVC编译Qt，就必须用VS2017配套的clang-cl版本编译应用
• 如果你要使用VS2019自带的clang-cl，需要重新用该版本clang-cl编译对应Qt的Release版本，不能混用不同版本编译链生成的Qt库

可落地的解决步骤 #

• 方案1：替换编译链，改用VS2017自带的clang-cl版本编译你的应用Release配置，保持和Qt编译链版本一致
• 方案2：保留现有VS2019 clang-cl，重新用该编译链完整编译对应版本Qt的Release包，再链接到你的应用
• 临时验证方案：可以在Release配置的clang-cl编译参数中添加/Z7、关闭/GL（全程序优化）、关闭/O2优化，大概率可以临时绕过链接报错，但不建议生产环境使用

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