Qt Creator本身不自带Qt版本，安装后需单独安装Qt SDK并在Tools→Options→Build & Run→Qt Versions中精确指向qmake路径（如/opt/Qt/6.8.2/gcc_64/bin/qmake）来手动添加，路径错误、权限不足、含中文或软链接均会导致添加失败。
安装 Qt Creator 时，它本身不自带 Qt 版本，Qt Creator 只是一个 IDE，真正决定你能构建什么项目的是你后续手动配置的 Qt Versions 和 Kits。所以“安装时选择 Qt 版本”这个动作并不存在——你得在安装完 Qt Creator 后，再单独安装 Qt（或通过在线安装器一并装上），最后在 Tools → Options → Build & Run → Qt Versions 里添加。
为什么 Qt Creator 安装包里没有 Qt？
Qt Creator 是纯编辑器+构建系统前端，和 VS Code 类似；而 qmake、libQt6Core.so、头文件这些属于 Qt SDK 的一部分，必须单独安装。官方在线安装器（qt-unified-windows-x64-4.x.x-online.exe）默认只装 Qt Creator，除非你在组件选择页主动勾选某个 Qt 版本（如 Qt 6.8.2）。
- 如果你用的是离线安装包（比如
qt-opensource-linux-x64-5.12.10.run），那它通常打包了 Qt SDK + Qt Creator，此时安装过程会把 Qt 装到指定路径，但依然需要你在 Qt Creator 中手动注册该路径 - 如果你只用
apt install qtcreator（如银河麒麟 V10），那系统只装了 IDE 二进制，qmake得自己找或自己装，否则打开就报“未检测到 Qt 版本” - Windows 下若 PATH 里已有
qmake.exe，Qt Creator 可能自动识别为Auto-detected，但这不可靠——依赖 PATH 顺序，且容易和旧版本冲突
怎么正确添加一个 Qt 版本到 Qt Creator？
关键不是“选”，而是“指向”：你要告诉 Qt Creator 哪个目录里有 qmake。路径必须精确到可执行文件，不能只给 Qt 安装根目录。
- 打开
Tools → Options → Build & Run → Qt Versions - 点击
+按钮，弹出文件选择对话框 - 定位到类似这样的路径：
C:\Qt\6.8.2\msvc2019_64\bin\qmake.exe（Windows）或/opt/Qt/6.8.2/gcc_64/bin/qmake（Linux） - 确认后，Qt Creator 会尝试调用
qmake -query验证有效性；失败则说明路径错、权限不足，或该qmake不兼容当前系统架构（比如在 aarch64 麒麟系统上用了 x86_64 的 qmake） - 验证成功后，该条目会显示版本号（如
Qt 6.8.2），状态为绿色对勾
常见错误：点了“Add”却看不到新版本，或提示“qmake not found”
这几乎全是路径或权限问题，不是 Qt Creator 的 bug。
-
qmake文件确实存在，但 Qt Creator 没权限读取（尤其 Linux 下用sudo qtcreator启动过一次，之后普通用户启动时 ~/.config/QtProject/qtcreator/ 的配置可能残留 root 权限） - 路径里含中文或空格（例如
C:\Program Files\Qt\...），Qt Creator 解析失败——重装到C:\Qt\这类干净路径 - 你选的是
qmake的软链接而非真实文件（Linux/macOS 常见），Qt Creator 无法 resolve，应直接指向qmake.real或实际二进制 - Qt 版本与编译器不匹配：比如选了
msvc2019_64目录下的qmake，但系统没装 Visual Studio 2019 运行库，qmake -query会静默崩溃
真正麻烦的从来不是“怎么加”，而是加完之后 Kit 配置是否对得上：同一个 qmake 路径，可能对应多个 Kit（比如 Desktop、Android、WebAssembly），每个 Kit 还要绑定正确的编译器、调试器、SDK 路径。漏掉任意一环，新建项目时照样报错。
