Qt Creator本身不自带编译器和Qt库，安装前必须明确目标平台与工具链匹配：Windows需选MinGW或MSVC（后者需先装Visual Studio），嵌入式Linux需提前准备交叉编译工具链，macOS默认用Clang但需确认Xcode命令行工具已安装，Linux用户通过包管理器安装的Qt Creator通常不带Qt库，仍需单独安装。
Qt Creator 本身不自带编译器和 Qt 库，安装前必须明确你到底要开发什么、在哪运行、用什么编译——否则装完打不开项目、构建失败、甚至 qmake 都找不到。
确认目标平台与编译工具链是否匹配
Windows 用户最容易踩坑：装了 Qt Creator 却没装 MinGW 或 MSVC，新建项目时直接报错 Cannot find a valid kit。这不是 Qt Creator 的问题，而是它找不到能干活的“手”。
- 开发 Windows 桌面应用 → 选 MinGW（推荐新手）或 MSVC（需先装 Visual Studio）
- 开发嵌入式 Linux 应用 → 需提前准备好交叉编译工具链（如
arm-linux-gnueabihf-gcc），Qt Creator 不会帮你装这个 - macOS 上默认用 Clang，但若要用 Qt 6.2+，需确认 Xcode 命令行工具已安装：
xcode-select --install - Linux 发行版用户注意：系统包管理器装的
qtcreator（如sudo apt install qtcreator）通常不带 Qt 库，仍需单独装qt5-default或下载官方离线包
检查 Qt 库版本与 Creator 兼容性
Qt Creator 是 IDE，Qt 是框架，二者版本不是严格绑定的，但存在实际兼容边界。比如 Qt Creator 12.0 对 Qt 5.9 支持有限，某些新功能（如 CMake Presets 支持）在老 Qt 版本里根本不可用。
- Qt 5.15 及更早版本 → 推荐用 Qt Creator 10.x 或 11.x（官方长期支持分支）
- Qt 6.2+ 项目 → 至少用 Qt Creator 11.0.2，否则
.cmake文件解析、QML 类型自动补全可能异常 - 别盲目追最新版 Creator：官网下载页标着 “LTS” 的才是稳定主力，日常开发优先选它
预留足够磁盘空间并配置环境变量（仅限离线安装）
离线安装包（如 qt-unified-windows-x64-12.0.2-offline.exe）解压后实际占用 >8 GB；若勾选多个 Qt 版本 + 文档 + 示例，轻松突破 20 GB。装一半失败很常见。
- 安装路径别含中文、空格或特殊字符（如
C:\Program Files\Qt容易触发权限/路径转义问题，建议用C:\Qt） - Windows 下若手动添加了
PATH，务必确认顺序：自己的mingw_64\bin目录必须在系统System32前，否则可能调用到系统自带的旧版gcc导致构建失败 - Linux/macOS 用户如果用在线安装器，它默认不写入
PATH，启动 Qt Creator 后首次配置 Kit 时，得手动指向qmake路径（通常是~/Qt/6.5.3/gcc_64/bin/qmake）
最常被忽略的是：Qt Creator 启动后第一次打开项目，会尝试自动探测 Kit，但探测逻辑依赖于环境变量、注册表（Windows）或 ~/.config/QtProject/qtcreator/ 下的缓存。如果之前装过旧版 Qt 或残留配置，Kit 列表可能为空或错乱——这时候不是重装 Creator，而是删掉 ~/.config/QtProject/qtcreator/（Linux/macOS）或 %LOCALAPPDATA%\QtProject\qtcreator\（Windows）再重启更有效。
