如何在Windows平台编译带专有编解码器的Qt WebEngine 5.11？

我之前在Windows上编译带专有编解码器的Qt WebEngine时，也踩过几乎一模一样的坑，下面针对每个错误给你具体的解决步骤：

1. 「Project ERROR: Cannot run compiler 'cl'...」错误 #

这个问题本质是VS的编译器环境变量没加载到位。cl.exe是Visual Studio的C/C++编译器，只有在VS专属的开发者命令提示符里才能正常调用。

• 解决步骤：
  • 打开Visual Studio安装目录下的「x64/x86 Native Tools Command Prompt」（比如VS2022的话，在开始菜单搜这个名字就能找到）；
  • 不要用普通的CMD或PowerShell直接编译，必须在这个专属提示符里执行qmake、nmake（或jom）等编译命令；
  • 如果习惯用PowerShell，可以手动执行VS的环境配置脚本，比如：

    "C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\VsDevCmd.bat"
    

    执行完再继续编译流程。

2. 「Needs VS 2015 Update 3...」或「Needs Visual Studio 2017 or Higher」错误 #

Qt WebEngine对Visual Studio版本有严格的版本绑定，不同Qt版本对应不同的最低VS要求：

• Qt 5.9~5.11：必须用VS2015 Update 3及以上版本；
• Qt 5.12及以后：要求VS2017及以上版本；
• 解决步骤：
  • 先确认你使用的Qt版本对应的VS版本要求，卸载不符合的旧版本；
  • 安装对应版本的VS时，务必勾选「C++桌面开发」 workload，里面包含了MSVC编译器、必要的库文件等核心组件，别漏选。

3. 「Could not detect Windows SDK Version...」错误 #

Qt WebEngine依赖Windows 10 SDK 10.0.10586或更高版本，这个错误要么是SDK没装，要么是环境变量没配置：

• 解决步骤：
  • 打开VS安装器，在「单个组件」里找到并安装「Windows 10 SDK（版本≥10.0.10586）」；
  • 如果已经安装但还是报错，手动添加系统环境变量：
    1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；
    2. 点击「系统变量」下的「新建」，变量名填WindowsSDKVersion，变量值填你安装的SDK版本号（比如10.0.19041.0，可以去C:\Program Files (x86)\Windows Kits\10\Include目录下查看对应的版本文件夹）；
  • 或者在开发者提示符里临时设置：

    set WindowsSDKVersion=10.0.xxx.0
    

4. 「C1905: Front end and back end not compatible...」错误 #

这是编译架构不匹配导致的，比如用x86的编译环境去编译x64的Qt WebEngine，或者反过来：

• 解决步骤：
  • 打开对应架构的开发者命令提示符：要编译x64版本就打开「x64 Native Tools Command Prompt」，编译x86就打开「x86 Native Tools Command Prompt」；
  • 执行qmake时明确指定架构，比如：

    qmake CONFIG+=x64
    

  • 确保Qt源码的配置、VS编译环境、目标架构三者完全一致，避免混合32位和64位的编译环节。

额外提醒：启用专有编解码器的关键步骤 #

别忘了在configure阶段加上专有编解码器的参数，否则即使编译成功也无法使用相关功能：

configure -prefix <你的Qt安装路径> -proprietary-codecs

另外要注意，使用H.264等专有编解码器需要符合对应的版权要求，确保你的使用场景合法。

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