报错“unknown module(s) in qt: webenginewidgets”本质是qt版本低于5.4、未安装webengine组件或使用了不兼容的mingw编译器；需检查qmake --version、通过maintenancetool勾选qt webengine，并确保kit中选用msvc而非mingw。
Qt Creator安装报错，绝大多数情况不是软件本身坏了，而是环境没对上——缺磁盘空间、路径含中文、编译器没装全、或 Qt 组件根本没选上。
Not enough disk space to store temporary files!
这是 Linux 或 Windows 上最常卡住的第一道门槛。安装程序解压时需要临时空间，哪怕你硬盘还有 20GB，/tmp 或系统默认临时目录可能已满。
- Linux 下运行
df -h查看/tmp和根分区剩余空间；Ubuntu 系统尤其要注意/var/tmp是否被日志塞满 - Windows 下检查系统盘（通常是 C:\）剩余空间是否 ≥ 5GB，临时目录默认在
C:\Users\{user}\AppData\Local\Temp - 可手动指定临时路径：启动安装程序时加参数
--temp-path D:\qt_temp（确保该目录存在且有写权限）
Unknown module(s) in QT: webenginewidgets
项目里写了 QT += webenginewidgets 却报这个错，说明 Qt 安装包里根本没包含这个模块，或者你用的构建套件不支持它。
- 确认 Qt 版本 ≥ 5.4：
qmake --version输出必须是 5.4 及以上；Qt 6.x 默认带，但 Qt 5.15 之后某些精简版会剔除 WebEngine - WebEngine 不支持 MinGW 编译器，只认 MSVC（如
msvc2019_64）；若你在 Qt Creator 左下角看到的是MinGW x64套件，换掉 - 重开 Qt MaintenanceTool.exe → “添加或移除组件” → 展开对应 Qt 版本 → 勾选
Qt WebEngine→ 安装完成重启 Qt Creator
缺少 Visual Studio 组件 / cl.exe not found
Qt Creator 提示找不到 MSVC 工具链，本质是它没找到 cl.exe、link.exe 这类编译器核心文件，不是 IDE 没装好，而是底层工具集缺失。
- 检查 VS 安装路径下是否存在
VC\Tools\MSVC\14.3x.xxxxx\bin\Hostx64\x64\cl.exe（x64 项目就看 x64 目录） - VS 安装时必须勾选“使用 C++ 的桌面开发”工作负载；只装 VS Code 或 Build Tools 精简版是不够的
- Qt Creator 的 Kits 页面里，Kit 的 Compiler 和 Debugger 要匹配：Compiler 选 MSVC，Debugger 必须选对应的
CDB（不是 GDB），否则即使能编译也调试不了
Qt 没有被正确安装，请运行 make install
这个提示专盯自己编译 Qt 源码的人。qmake 找不到 qt.conf，就不知道 Qt 安装在哪，直接拒绝加载。
- 进入你编译生成的 Qt
bin目录（比如/home/user/qt-build/qtbase/bin） - 新建文件
qt.conf，内容只有两行：[Paths] Prefix=..
（注意Prefix=..是相对路径，指向 Qt 根目录） - 别漏掉
lib目录下的pkgconfig文件夹——如果缺失，qmake -query会显示QT_INSTALL_LIBS为空
真正容易被忽略的点是：Qt Creator 启动时读取的是当前 Kit 对应的 qmake 路径，而不是全局 PATH 里的那个；哪怕你 which qmake 能输出，Qt Creator 仍可能用错版本。务必在 “构建和运行 → Qt 版本” 里手动指定你真正想用的 qmake 路径，而不是依赖自动探测。
