Qt5.x 编译QWebenginewidgets出现错误Project ERROR: Unknown module(s) in QT: webenginewidgets

最新推荐文章于 2025-05-22 16:00:26 发布
原创 最新推荐文章于 2025-05-22 16:00:26 发布 · 2.3w 阅读 · 10 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文介绍了编译QtWebEngineWidgets时遇到的未知模块错误及解决方法，并详细阐述了如何让QtWebEngine支持HTML5中的mp4文件播放。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

问题一：编译QWebEngineWidgets出现错误Project ERROR: Unknown module(s) in QT: webenginewidgets
原因：    因为Qt默认没有安装“webenginewidgets”和“webengine”模块的软件包。

方法一：源码编译webenginewidgets

方法二：换成Visual studio编译环境，可以使用其静态库文件。


    再直接编译即可！

————————————————————————————————————————————————

问题二：使用QtWebEngine开发的浏览器无法播放HTML5中的mp4文件？
原因：   QtWebEngine 不带mp4解码器

方向一：使Qt内嵌FlashPlay  

方法二：添加mp4的解码器

            尝试添加mp4解码器。

            原理：利用QtWebEngine 和chrome使用的都是chromium 内核。QT借助Chrome的解码器。

            步骤如下：

                1.下载安装一个chrome，其版本要与QtWebEngine的一致。

              2.取Chrome安装目录下的ffmpegsumo.dll，将ffmpegsumo.dll放到QT的安装目录……\plugins\qtwebengine\下面。（当生成目标程序的时候，也将plugins\qtwebengine\ffmpegsumo.dll放到安装包内）





Qt5/6解决Mingw下Project ERROR: Unknown module(s) in QT: “webenginewidgets” 及类似webview等web插件无法找到的问题
有问题或资源连接有缺失的可以私信公众号新潮看世界获取
03-16 6875
也不知道QtMingw从什么时候开始，在Windows下编译Web相关的工程时，已经无法找到webview，webengine，webenginewidgets等等插件了。 在Qt5.15里面也已经找不到web相关的example了。 如果你编译的工程中带有webview等的控件，那么基本都会出现Project ERROR: Unknown module(s) in QT: “webview”，QT += webview不好使了。 但是如果你将这个工程放在Visual studio中编译，却又可以编译
解决QT 编译QWebEngineWidgets出现错误Project ERROR: Unknown module(s) in QT: webenginewidgets问题
一只攻城狮的博客
10-15 2万+
解决QT 编译QWebEngineWidgets出现错误Project ERROR: Unknown module(s) in QT: webenginewidgets问题 1. 确认你的QT版本号为QT5.4+，在此之后的版本Qt WebEngine取代之前的Qt Webkit；且只有MSVC才支持该对象。 2. 接下来确认你是否安装了WebEngine库；在你的安装的QT文件夹里有一个MaintenanceTool.exe应用程序，你可以更新和查看是否安装了WebEngine，或者你可以在QT文件夹中搜
【最全踩坑】Qt项目解决Unknown module(s) in QT: webenginewidgets问题
daviddou2022的博客
07-27 8005
Qt项目遇到Unknown module(s) in QT: webenginewidgets问题一系列踩坑指南
跨平台QT5应用程序开发：集成qtwebengine模块
weixin_30633869的博客
05-22 1216
Qt5作为一款强大的跨平台应用程序和用户界面框架，自2012年发布以来，便以其模块化、性能优异和丰富的API库，在GUI开发领域大放异彩。本章节首先介绍Qt5的基本概念、历史发展及其核心特点，为读者铺垫对Qt5框架的基本理解和应用背景。在当今的软件开发中，集成Web内容已成为一种常见需求，为了在Qt应用中实现这一功能，Qt提供了一个强大的模块：qtwebengine。这个模块基于Chromium项目，旨在提供现代浏览器的Web引擎功能，以支持复杂Web内容的显示和交互。
Project ERROR: Unknown module(s) in QT: webenginewidgets
aoxuestudy的专栏
03-11 8420
Project ERROR: Unknown module(s) in QT: webenginewidgets QT += webenginewidgets这句后，编译一直报下面错误 Project ERROR: Unknown module(s) in QT: webenginewidgets
Ubuntu下QT项目报错：Project ERROR: Unknown module(s) in QT: webenginewidgets
CODES001的专栏
11-14 2132
Ubuntu下的QT报错：Project ERROR: Unknown module(s) in QT: webenginewidgets解决方法
解决Project ERROR: Unknown module(s) in QT: “webenginewidgets” 的问题_windows10下使用Qt安装MSVC2017
没刮胡子的程序员专栏
08-30 4323
问题描述 在Qt5中使用webenginewidgets开发，编译就发现提示QT: module “webenginewidgets” is not installed的问题，查了一下资料，在windows下使用Qt开发使用webenginewidgets需要安装MSVC，查看了对应的版本Qt5需要安装 ...
QT错误Unknown module(s) in QT: webenginewidgets详解
GreenHand的博客
02-21 2万+
最近在编写QT程序时，遇到了下列问题，QT报错： error: Unknown module(s) in QT: webenginewidgets 问题在于要编写的程序需要使用webenginewidgets的相关内容，本人所使用的QT版本为QT5.5.1+MSVC2010，在网上经过一番查找，终于找到了问题所在： 在开始时，我认为是安装时出现问题，没有安装对应的系统模块，但是在安装文件夹下...
Unknown module(s) in QT: webenginewidgets原因及解决办法
sinat_41928334的博客
06-27 4万+
今天学习时，想使用QWebEngineView做一个显示网页的小项目。在.pro文件中加入QT += webenginewidgets这句后，编译一直报下面错误 Project ERROR: Unknown module(s) in QT: webenginewidgets 查资料常见原因以下三种： 1）QT版本过低。需要QT版本号为QT5.5版本及其以上。从Qt5.5开始，Qt WebKit模块被废弃，取而代之的是Qt WebEngine模块。且只有MSVC才支持该...
QT- Project ERROR: Unknown module(s) in QT: webenginewidgets
听我一言的博客
07-11 1万+
1. Qt模块加载错了 Qt WebKit QT += webkitwidgets Qt WebEngine QT += webenginewidgets 2. MSVC版本低 本人使用Qt5.12.4 ， MSVC为2015, 结果编译错误, 最终选用编译为2017，成功通过编译 ...
解决 "ERROR: Unknown module(s) in QT: webengine" 办法
hanhanluma
04-20 3868
环境： window 10, Qt 5.13.0 问题描述： 需要使用到WebEngineView组件用来显示，在工程.pro中增加webengine后，Qt Creator应用程序输出中打印了 Project ERROR: Unknown module(s) in QT: webengine 解决办法： 以为是自己没有安装相应的模块，于是在虚拟机里重新安装测试，发现如下信息： ...
Ubuntu下QT项目报错：Unknown modules in QT: webenginewidgets
weixin_54453948的博客
03-24 976
通过下面的命令安装webengine模块：4、重启就可以编译通过了。
解决 “Project ERROR: Unknown module(s) in QT: webengine” 办法
热门推荐
余俊武alex的博客
01-04 4万+
环境： window 10, Qt 5.12.0 问题描述： 需要使用到WebEngineView组件，在工程.pro中增加webengine后，Qt Creator应用程序输出中打印了 Project ERROR: Unknown module(s) in QT: webengine 解决办法： 以为是自己没有安装相应的库，于是打开Qt Maintenance Tool看了一下： ...
QT：Unknow module(s) in QT :webenginewidgets
twilight1999的博客
05-06 3141
解决QT：Unknow module(s) in QT :webenginewidgets 在拿QT做浏览器练习的时候，遇到了缺失webenginwidgets组件的问题，我的环境是：QT5.14+MSVC2017 64 bit 反复查阅无法解决，网络上现有的解决方案都是和环境部署有关 就在我临近放弃之时，偶然读到安装QT时不会默认安装webenginewidgets组件。所以，解决方法如下： 1...
unknow module(s) in QT:webenginewidgets 问题的解决办法 适用于window下的开发环境
weixin_45941231的博客
08-18 1298
unknow module(s) in QT:webenginewidgets 问题的解决办法 适用于window下的开发环境
QT5.12 使用QWebEngineView error: Unknown module(s) in QT: webenginewidgets
weixin_65652643的博客
10-08 905
QT5.12 使用QWebEngineView 编译后出现如下错误，如何处理呢？
linux Unknown module(s) in QT:webenginewidgets
hm_123123123的博客
07-05 2861
linux Unknown module(s) in QT:webenginewidgets
初学QT，Project ERROR: Unknown module(s) in QT: webkitwidgets， 这个编译错误怎么解决
wangtingze123的博客
11-12 1万+
根据Qt官方的解释（在Qt的帮助文档里也可以看到），在5.6版本以及之后的版本，Qt已经移除了webkitwidgets模块，并用一个新的模块webenginewidgets替代之。 Qt5.5.1是最后一个支持webkitwidgets的版本。 QT       += core gui webenginewidgets...
在qt里显示:-1: error: Project ERROR: Unknown module(s) in QT: webenginewidgets
最新发布
08-20
<think>我们正在处理一个Qt编译错误：Project ERROR: Unknown module(s) in QT: “webenginewidgets” 根据引用内容，这个问题通常出现在使用MinGW编译Qt的Web相关模块时，而使用MSVC（Visual Studio）则可能正常。 原因：Qt的WebEngine模块在Windows上需要MSVC编译器，MinGW可能不支持或需要额外配置。 解决步骤： 1. 确认是否安装了WebEngine库。 在Qt安装目录下，使用MaintenanceTool.exe（Qt维护工具）检查是否安装了Qt WebEngine模块。 或者，在Qt安装目录中搜索“Qt5WebEngine”或类似名称的文件夹，确认存在。 2. 如果确认已安装，则检查项目使用的构建套件（Kit）。 错误信息中提到的“Unknown module”通常意味着当前构建套件没有包含WebEngine模块。 注意：WebEngine模块在Windows上仅支持MSVC编译器，不支持MinGW。 3. 因此，解决方案是： a. 安装MSVC构建套件（如果尚未安装）。 在Qt安装时，选择安装MSVC版本的Qt库（例如：Qt 5.15.2 MSVC2017 64-bit）。 b. 安装对应的Visual Studio版本（例如MSVC2017需要VS2017）。 c. 在Qt Creator中，切换到MSVC构建套件。 4. 如果已经安装了MSVC版本的Qt，但在Qt Creator中没有检测到，可能需要手动设置构建套件。 打开Qt Creator -> 工具 -> 选项 -> Kits，检查MSVC套件是否被正确识别。 5. 在项目配置文件（.pro文件）中，确保已经添加了： QT += webenginewidgets 然后，使用MSVC构建套件重新构建项目。 6. 如果不想使用MSVC，也可以考虑使用其他不需要WebEngine的组件（如WebView），但WebView在Windows上同样需要MSVC。 注意：根据引用[2]，如果MSVC套件显示为不可用（如缺少编译器），则需要安装对应的Visual Studio版本。 总结：在Windows上使用Qt的WebEngine模块，必须使用MSVC编译器，不能使用MinGW。 相关问题： 1. 如何检查Qt安装的模块？ 2. 如何在Qt Creator中切换构建套件？ 3. 如何安装特定版本的Visual Studio以支持Qt的MSVC编译？ 4. 除了使用MSVC，还有其他方法在MinGW下使用WebEngine吗？</think>### 解决 Qt 项目中的 "Unknown module(s) in QT: webenginewidgets" 错误 #### 问题原因分析 该错误通常由以下原因导致： 1. **WebEngine 模块未安装** Qt 的 WebEngine 模块（含 `webenginewidgets`）需要单独安装，默认安装可能不包含此组件[^1][^2]。 2. **编译器不兼容** WebEngine 模块在 Windows 平台 **仅支持 MSVC 编译器**（如 Visual Studio），不支持 MinGW 编译器[^1][^2]。这是 Qt 官方的技术限制。 3. **构建套件配置错误** 项目使用了 MinGW 构建套件（Kit），但未正确关联 MSVC 套件[^2]。 --- #### 解决方案（分步操作） ##### 步骤 1：确认 WebEngine 模块安装 1. 打开 Qt 维护工具 `MaintenanceTool.exe`（位于 Qt 安装目录） 2. 在 **添加或移除组件** 界面中，检查以下组件是否已安装： ☑️ `Qt` > `Qt 版本` > `WebEngine`（例如：`Qt WebEngine 5.15.2`） ☑️ 对应编译器版本（如 `MSVC 2019 64-bit`） 3. 如未安装，勾选后点击更新（需联网）[^2]。 ##### 步骤 2：配置 MSVC 构建套件 1. **安装 Visual Studio** 下载并安装与 Qt 版本匹配的 VS（如 Qt 5.15 需 VS2019）[^2]。 2. **在 Qt Creator 中配置套件**： - 打开：`工具` → `选项` → `Kits` → `构建套件(Kit)` - 选择 MSVC 套件（如 `Desktop Qt 5.15.2 MSVC2019 64bit`） - 确保编译器、调试器路径正确（通常自动检测） ##### 步骤 3：切换项目构建套件 1. 在 Qt Creator 左下角： - 从 `MinGW` 切换到 `MSVC` 套件（例如：`MSVC 2019 64bit`） - ![构建套件切换示意图](https://example.com/kit-switch.png)（图示参考）[^2] 2. 清理并重新构建项目： `构建` → `重新构建项目` ##### 步骤 4：验证 .pro 文件配置 确保项目文件（`.pro`）包含： ```qmake QT += webenginewidgets core gui ``` --- #### 替代方案（如无法使用 MSVC） 1. **使用 QWebView 替代** 修改代码，用 `QWebView`（需 `QT += webkitwidgets`）替换 `QWebEngineView`，但功能有限。 2. **跨平台编译** 在 Linux/macOS 下使用 MinGW 编译 WebEngine（Windows 不可行）。 --- ### 相关问题 1. 如何检查 Qt 安装的 WebEngine 模块版本？ 2. MSVC 和 MinGW 编译器在 Qt 开发中的主要区别是什么？ 3. 如何为 Qt WebEngine 项目配置离线文档？ 4. Qt 6 中 WebEngine 模块有哪些重大变更？ > ⚠️ 注意：WebEngine 模块依赖 Chromium 内核，在 Windows 上必须使用 MSVC 编译，这是 Qt 官方的明确限制。尝试 MinGW 编译可能导致更复杂的错误[^1][^2]。 [^1]: Qt5/6 解决 Mingw 下 Project ERROR: Unknown module(s) in QT: “webenginewidgets” [^2]: 解决 QT 编译 QWebEngineWidgets 出现错误 Project ERROR: Unknown module(s) in QT: webenginewidgets 问题
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值