Qt Creator 必须与 Qt 库和编译器工具链配套安装，仅装 IDE 无法新建或编译项目；启动提示“未配置 Qt 版本”是因为在线安装器默认不附带 Qt 库和编译器，需手动勾选对应版本的 Qt Libraries（如 Qt 6.7.2 for MinGW 64-bit）及编译器（MinGW 13.1.0 或 MSVC），且二者 ABI 必须严格匹配。
Qt Creator 不是单独安装的 IDE，它必须和 Qt 库、编译器工具链一起部署；只装 qtcreator 本身无法新建或编译项目——这是新手最常卡住的第一步。
为什么装完 Qt Creator 启动后提示“未配置 Qt 版本”
因为官方在线安装器默认只装 qtcreator，不自动带任何 Qt 库或编译器。你看到的“Qt Creator”只是个壳，真正干活的 qmake、cmake、mingw_64 或 msvc2022_64 都得手动勾选。
- Windows 下若没装 Visual Studio，就一定要勾选
MinGW 64-bit（比如MinGW 13.1.0 64-bit），否则连“Hello World”都编译不过 - 勾选 Qt 版本时，别只看“Qt 6.x.x”，要展开子项，确认勾了对应编译器的
Qt Libraries（例如Qt 6.7.2 for MinGW 64-bit） - 路径中含中文、空格、特殊符号（如
C:\Users\张三\Documents）会导致qmake解析失败，报错类似Project ERROR: Unknown module(s) in QT: core widgets
Ubuntu 下用 apt 装的 qtcreator 为什么建不了项目
Ubuntu 官方源里的 qtcreator 包不含 Qt 库，只装了 IDE 二进制；qt5-default 也只提供基础头文件和 qmake，缺编译器和完整模块（如 QtSerialPort、QtCharts）。
- 执行
sudo apt install qtcreator qt5-default build-essential libgl1-mesa-dev是最低可用组合 - 但想用 Qt6，必须去官网下载离线包或用在线安装器——
apt目前不提供qt6-base等核心库 - 首次启动后，在
选项 → 构建和运行 → Qt 版本里点“添加”，路径填/usr/lib/x86_64-linux-gnu/qt5/bin/qmake（Qt5）或/opt/Qt6.7.2/6.7.2/gcc_64/bin/qmake（手动装的 Qt6）
安装时哪些组件能省，哪些绝不能少
精简安装的核心原则：只留当前项目需要的编译目标 + 最小必要模块。装多了不仅占空间，还会让 Qt Creator 启动变慢、构建配置混乱。
- 必选：
Qt Creator（IDE）、对应平台的Qt Libraries（如Qt 6.7.2 for MinGW 64-bit）、对应编译器（MinGW 13.1.0 64-bit或MSVC v143 64-bit） - 按需选：
Qt Serial Port（串口通信）、Qt Charts（绘图）、Qt HTTP Server（内嵌 HTTP 服务）——不勾就不会出现在QT +=可选项里 - 可跳过：
Qt for WebAssembly、Qt for Android、Qt Quick Designer（纯 Widgets 项目不需要）、所有Examples和Documentation（占 10GB+）
真正容易被忽略的是编译器与 Qt 版本的 ABI 兼容性：MSVC 编译的 Qt 库不能用 MinGW 编译，反之亦然；装完后在 构建和运行 → 编译器 里看到的 gcc 或 cl.exe，必须和 Qt 版本 列表里那个括号中的编译器标识完全一致，否则新建项目时会直接灰掉“下一步”按钮。
