Qt Creator能否运行取决于Kit是否被正确识别，典型现象是右下角黄色感叹号或新建项目时Kit下拉为空；需依次检查Compilers、Qt Versions是否有效，避免中文路径和空格，并确保配置后重启IDE。

Qt Creator 能不能跑起来，不取决于你装了多少组件，而取决于 Kit 是否能被正确识别 —— 这是绝大多数人卡在第一步的根本原因。

Kit 配置失败的典型现象和检查点

启动 Qt Creator 后右下角 Kit 图标显示黄色感叹号，或新建项目时“构建套件”下拉为空，Projects > Build & Run > Kits 里显示“None available”。这说明 Qt Creator 找不到可用的编译器 + Qt 版本组合。

• 先确认 Build & Run > Compilers 中是否已自动检测到编译器（如 MinGW 11.2、MSVC 2019 或 GCC）；若为空，需手动添加路径（Windows 下通常是 C:\Qt\Tools\mingw112_64\bin\g++.exe）
• 再检查 Build & Run > Qt Versions 是否列出了有效的 qmake 路径（如 C:\Qt\6.5.0\mingw_64\bin\qmake.exe）；路径错误或权限不足会导致识别失败
• macOS 用户特别注意：qmake 必须能通过终端直接执行；如果用 Homebrew 安装 Qt，qmake --version 应返回结果，否则需补全 PATH（例如 export PATH="/opt/homebrew/opt/qt/bin:$PATH"）

控制台输出看不到 console.log 的真实原因

QML 项目的 console.log 默认不输出到 Qt Creator 的“应用程序输出”面板，不是代码写错了，而是运行配置没打开调试通道。

Qt Creator 18.0.2

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

下载

• 必须勾选 Projects > Run > Run in terminal，否则 console.log 会被静默丢弃（尤其在 Windows 上）
• 若仍无输出，检查 Run > Run Environment > Add，手动添加环境变量：QT_LOGGING_RULES=qt.qml.debug=true;*.debug=true
• Linux/macOS 下还需确认终端模拟器支持 ANSI 颜色（Qt Creator 内置终端有时会禁用颜色输出，导致日志被过滤）

中文路径和空格引发的构建失败

Qt 工具链对路径中的中文和空格极度敏感，qmake 和 moc 在解析路径时会直接报错，且错误信息常被截断，只显示 Project ERROR: Unknown module(s) in QT: core gui 这类误导性提示。

• 项目保存路径必须是纯英文、无空格、无括号（如 C:\dev\myapp，而非 C:\用户\张三\桌面\我的项目）
• Qt 安装路径同理：避免 C:\Program Files\Qt（空格导致 qmake 解析失败），推荐 C:\Qt
• macOS 上还要避开 iCloud 同步目录（如 ~/Library/Mobile Documents/），这类路径有隐藏符号链接，qmake 无法稳定访问

Kit 是 Qt Creator 的心脏，但它的状态不会主动提醒你——它只沉默地拒绝构建。每次改完编译器或 Qt 版本路径，务必点击 Apply 后关闭再重开 Qt Creator，否则缓存可能让你误以为配置已生效。