qt creator 和 qt 库是两个独立组件，官方推荐使用 qt online installer 一键安装并自动配置；该安装器自 qt 5.15+ 起取代离线包，支持多版本共存、按需增删组件，安装路径须避免中文和空格以确保工具链正常运行。
Qt Creator 和 Qt 库不是同一个东西，但官方安装器默认把它们打包在一起——只要一次安装、正确勾选，就能直接用，不用手动配路径或环境变量。
Qt Online Installer 是唯一推荐的安装方式
- 官方早已停更离线全量包（尤其 Qt 5.15+ 和全部 Qt 6.x），
qt-online-installer是目前最稳定、组件最全、更新最及时的方式 - 它本质是个「组件管理器」，不是传统意义上的“安装程序”：装完后还能随时增删 Qt 版本、编译器、文档、示例，甚至回滚某个组件
- 不需要登录也能跳过账号验证：断网运行安装器，或在登录页直接关掉网络，点“Skip”即可继续
你真正要做的，只是在安装过程中盯住三处勾选项：
- ✅
Qt Creator（IDE 本身，建议只装一个，随高版本 Qt 安装） - ✅ 某个
Qt版本（如Qt 5.15.2或Qt 6.8.0） - ✅ 对应的编译器（Windows 推荐
MinGW 11.2 64-bit；已装 VS2022 就选MSVC 2022）
其他像 Examples、Documentation、Qt Charts 等可按需取消，节省 2–3GB 空间，不影响编译运行。
安装路径必须不含中文和空格
- 错误路径：
C:\Program Files\Qt（含空格）、D:\我的Qt项目（含中文） - 正确路径：
D:\Qt、E:\dev\qt、/opt/qt（Linux/macOS） - 原因：
qmake、moc、uic等工具链对路径敏感，空格会导致构建失败，中文可能引发编码解析错误（尤其在 CMake 项目中）
安装完成后，Qt Creator 会自动识别已装的 Qt 版本和编译器，无需进 Tools → Options → Build & Run 手动添加——除非你后续又用源码编译了另一个 Qt（比如 ARM64 交叉编译版），那才需要手动注册 qmake 路径。
多 Qt 版本共存，但不要装多个 Qt Creator
- 同一台机器可以同时装
Qt 5.15.2和Qt 6.8.0，甚至Qt for WebAssembly，互不干扰 - 但
Qt Creator只需装一个（推荐随 Qt 6.8.0 安装的那个），然后在Options → Build & Run → Kits里为每个 Qt 版本建一个 Kit：选对应Qt version+ 对应Compiler - 如果你手滑装了两个
Qt Creator（比如随 Qt5 和 Qt6 各装了一次），卸载旧的那个——多实例容易导致插件冲突、调试器卡死、配置文件错乱，且 IDE 启动变慢
实际操作中最容易被忽略的一点：安装完别急着新建项目。先打开 Qt Creator，进 Tools → Options → Build & Run → Kits 看一眼是否已有可用 Kit。如果显示 Unconfigured，说明编译器或 Qt 版本没识别上——大概率是路径含空格/中文，或者 MinGW 没装全（缺 gdb 或 mingw32-make）。这时候再回头检查安装路径和组件勾选，比重装快得多。
