安装Qt Creator时应精准勾选组件：只选所需Qt版本（如MinGW 11.2或MSVC 2022）、必装Qt Creator和CMake，禁用Android/iOS/WebAssembly等冗余模块，路径须无中文空格，并确保Kit中编译器、Qt版本、调试器三者匹配。
装 Qt Creator 时乱勾组件，轻则浪费 10GB 空间、编译报错，重则 Kit 配不起来、qmake 找不到、CMakeLists.txt 一开就红。关键不是“全选省事”，而是按你真要用的来选。
只装真正需要的 Qt 版本和编译器
Qt 在线安装器里，“Qt”目录下每个版本（比如 Qt 6.5.3）会展开一堆子项，里面混着 MinGW、MSVC、iOS、Android 等各种编译目标。你只需要勾一个：
- 用 Qt Creator 自带构建 → 勾
MinGW 11.2.0 64-bit（Windows 默认推荐，兼容性好，调试器gdb.exe自带） - 用 Visual Studio 写代码、但用 Qt Creator 编译 → 勾对应 VS 版本的
MSVC 2019 64-bit或MSVC 2022 64-bit（注意：必须已装 VS，否则 Kit 里编译器会标红） - 不勾
Android/iOS/WebAssembly—— 这些模块下载慢、占空间大，且桌面开发完全用不到
Tools 目录下只留核心工具链
Tools 分类里容易误选一堆“看起来有用”的东西，其实多数是冗余的：
- 必勾：
Qt Creator（IDE 本体）、CMake（Qt 6.5+ 默认用 CMake 构建，没它新建项目直接失败） - 可选但建议勾：
GDB（MinGW 调试必需）、Qt HTTP Server（做本地 API 演示用得上） - 别勾：
Qt Design Studio（UI 设计工具，QWidget 开发几乎不用）、Qt Quick Compiler（QML 优化用，C++ 桌面项目无感）、所有带Preview字样的组件（不稳定，易导致 Creator 启动崩溃）
Qt 模块按实际功能需求加装
Qt 库本身是模块化设计，Widgets 是基础，其余模块不装就不会链接、不打包、不拖慢编译。常见组合：
- 纯窗口程序（对话框/主窗口）→ 只要
Qt Widgets（自动带Core、Gui） - 带图表 → 加
Qt Charts（注意：Qt 6 中需额外在CMakeLists.txt里写find_package(Qt6 COMPONENTS Charts)） - 串口通信 → 加
Qt Serial Port（Windows 下QSerialPort依赖此模块，漏装编译时报undefined reference to `QSerialPort::...`） - 播放音视频 → 加
Qt Multimedia（但注意：Qt 6.5+ 的 Windows 默认后端是Windows Media Foundation，若系统精简过可能失效）
安装路径和环境变量最容易被忽略的坑
装完不等于能用。两个硬性条件必须手动核对：
- 安装路径不能含中文、空格、特殊字符（比如
D:\Qt\6.5.3\mingw_64OK，D:\Program Files\Qt或D:\我的Qt会导致qmake解析路径失败） - 安装后必须检查
PATH是否自动加入了bin目录（如D:\Qt\6.5.3\mingw_64\bin）；没加的话，命令行运行qmake --version或cmake --version会提示“不是内部或外部命令” - 打开 Qt Creator →
Tools > Options > Kits→ 看Compiler和Debugger是否自动识别；如果Compiler显示 “None”，说明 MinGW 路径没扫到，得手动点Add指向mingw_64\bin\g++.exe
最常卡住的地方不是组件没装全，而是 Kit 里编译器、Qt version、debugger 三者没对齐——比如选了 MinGW 64-bit 编译器，却配了个 MSVC 版本的 Qt，或者 gdb 路径指向了旧版 Qt 的 bin 目录。这种错不会报明显错误，只是构建时卡在 “Running CMake…” 一直转圈。
