需检查Qt版本（≥5.4）、编译器（Windows用MSVC非MinGW）、组件（通过MaintenanceTool安装Qt WebEngine）；其他常见问题包括杀毒软件拦截、残留进程占用、目录权限不足、编译器未安装或Kit配置错误、Linux下缺失gdb及调试符号库。

“Unknown module(s) in QT: webenginewidgets”怎么修

这个错误不是代码写错了，而是 Qt 环境没配齐。核心就三点：版本够不够、编译器对不对、组件装没装。

• webenginewidgets 模块从 Qt 5.4 才正式支持，低于这个版本直接不认——用 qmake --version 看清楚你用的是哪个 Qt 版本
• Windows 下 MinGW 编译器无法编译 webenginewidgets，官方只认 MSVC（比如 Desktop Qt 6.5.3 MSVC2019 64-bit 这类 Kit），Kit 切错就报这个错
• 即使版本和编译器都对，也得确认 Qt WebEngine 组件真装了：运行 MaintenanceTool.exe → “添加或移除组件” → 展开对应 Qt 版本 → 勾选 Qt WebEngine → 安装完成重启 Qt Creator

“cannot open output file”编译卡在链接阶段

这不是代码问题，是文件系统被锁死或权限拦住了。90% 的情况发生在 Windows 上，且往往悄无声息。

Qt Creator 18.0.2

Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。

下载

• 杀毒软件（尤其是 360、腾讯电脑管家）会拦截 Qt 生成的临时可执行文件，表现为 cannot open output file xxx.exe 或 Permission denied —— 临时关闭实时防护再试一次，立竿见影
• 残留进程占着输出文件：任务管理器里搜 xxx.exe（你的项目名）或 qmake、mingw32-make，强制结束所有相关进程
• debug/release 目录权限异常：右键项目根目录 → “属性” → “安全” → 确保当前用户有“完全控制”；若仍不行，试试以管理员身份运行 Qt Creator

“Cannot run compiler clang++” Kit 配置错乱

Qt Creator 不自带编译器，它只是个调度器。报这个错，说明你选的 Kit 对应的编译器根本没装，或者路径断了。

• 先确认系统里真有 clang++：终端输 clang++ --version，返回“command not found”就说明没装——得单独装 LLVM，不能只靠 Qt 安装包
• 检查当前 Kit 是否真的指向你本地有的编译器：菜单栏“工具”→“选项”→“Kits”→左侧选中当前 Kit → 右侧看 “Compiler” 和 “Debugger” 是否都非空且状态为绿色
• 常见陷阱：别人项目用了 MinGW，你本地只有 MSVC；或反过来。最稳做法是删掉自动匹配的 Kit，手动新建一个，明确指定已验证可用的编译器和 Qt 版本

Linux 下调试器启动失败：“无法找到调试器 ‘gdb’”

Qt Creator 默认依赖系统级 gdb，但它不会帮你装，也不会提示缺什么。

• Ubuntu/Debian 系：直接跑 sudo apt-get install gdb，装完重启 Qt Creator 即可识别
• 如果装了 gdb 还报错，大概率是缺调试符号库：sudo apt-get install libc6-dbg（尤其在调试 Qt 自身或系统库时必需）
• 某些发行版（如 Fedora）默认不带 gdb 图形前端，需额外装 gdb-gui 或确保 gdb 在 $PATH 里——用 which gdb 验证路径

Qt Creator 报错真正麻烦的从来不是错误信息本身，而是它把底层环境问题包装成“项目出错”的假象。盯住报错里的关键词（webenginewidgets、output file、clang++、gdb），顺着它往环境层挖，比反复改代码高效得多。