Qt Creator安装需手动勾选三项核心组件并验证构建套件，项目路径须全英文无空格、名称不能数字开头；下载时认准官方架构包并校验SHA256，避免误装在线安装器或离线下载损坏包。
Qt Creator 本身不带编译器和 Qt 库，装完直接新建项目大概率报错——这是新手最常卡住的第一步。别急着点“下一步”，先看清该下什么、装什么、勾什么。
下载时只认准两个关键信息：qt-creator-opensource 和对应系统的架构
官方下载页（https://download.qt.io/archive/qtcreator/）里版本多、命名杂，容易选错。Windows 用户必须选带 x86_64 的安装包，比如 qt-creator-opensource-windows-x86_64-4.14.0.exe；Linux 用户注意区分 x64 和 arm64，Ubuntu 22.04+ 用 x64；macOS 则看是否支持 Apple Silicon（带 arm64 的包才能在 M 系列芯片上原生运行）。
常见踩坑点：
- 误下
qt-unified-windows-x64-online.exe（在线安装器）：它默认装几十 GB 全家桶，新手根本用不上 - 用迅雷或百度网盘离线下载：校验失败概率高，建议浏览器直连清华源
https://mirrors.tuna.tsinghua.edu.cn/qt/official_releases/qtcreator/ - 没核对 SHA256：下载完务必比对官网提供的哈希值，否则可能安装中途崩溃或缺失组件
安装过程中必须手动勾选的三项
运行安装程序后，到“选择组件”页面，以下三项不能靠默认：
-
Desktop Qt 5.15.2 MinGW 64-bit（Windows）或Desktop Qt 6.5.3 GCC 64-bit（Linux/macOS）：这是能跑起来的最小 Qt + 编译器组合，缺了就建不了Qt Widgets Application -
Qt Creator本体：有些镜像包会把它默认取消勾选，漏掉就只剩个空壳安装目录 -
CMake工具（如果选 CMake 构建系统）：Qt 6 默认用 CMake，不装它，新建项目时会提示CMake not found
其他如 Qt Charts、Qt Serial Port 按需勾选，但首次安装建议先不勾——它们不参与基础编译链，装多了反而拖慢安装速度、增加路径冲突风险。
装完别急着建项目，先验证 构建套件 是否就位
启动 Qt Creator 后，进 工具 → 选项 → 构建和运行 → 构建套件，你会看到列表里至少有一条状态为绿色的条目，形如：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
Desktop Qt 5.15.2 MinGW 64-bit (default)
如果没有，说明 Qt 版本或编译器没被自动识别，需要手动添加：
- 在
Qt 版本标签页点击添加，指向你安装目录下的5.15.2\mingw81_64\bin\qmake.exe（Windows）或Qt/6.5.3/gcc_64/bin/qmake（Linux/macOS） - 在
编译器标签页确认MinGW GCC或GCC已列出，路径指向mingw81_64\bin\g++.exe或/usr/bin/g++ - 最后回到
构建套件，点击添加，把刚配好的 Qt 版本和编译器组合起来
这个环节最容易被跳过，结果新建项目时卡在 No valid kits found，其实只是 Qt Creator 没找到“能干活的搭档”。
第一次新建项目时路径和名称的硬约束
创建新项目窗口里，项目路径 和 项目名称 必须满足三个条件，否则后续编译、调试、部署全崩：
- 路径不能含中文字符：哪怕只是
桌面这种文件夹名也会触发qmake: could not exec '/usr/lib/qt5/bin/qmake': No such file or directory - 路径不能含空格：例如
C:\My Projects\hello在 Windows 下会导致sh: -c: line 0: syntax error near unexpected token `(' - 项目名称不能以数字开头：比如
1test会让.pro文件生成失败，因为 Qt 的变量命名规则不允许
最保险的写法是全英文小写、下划线分隔、无空格，例如 hello_world，路径设为 C:\dev\hello_world（Windows）或 ~/dev/hello_world（Linux/macOS）。
真正麻烦的不是装不上，而是装完以为好了，结果在 构建套件 配置和项目路径这两个地方静默失败——它们不报红错，但会让你在“运行”按钮上反复碰壁。
