qt creator中kit由qt版本、编译器、调试器三者严格组合而成,缺一不可且架构必须一致:qt versions须指向交叉编译版qmake(如/opt/qt5.9.9/bin/qmake),编译器需匹配abi(如arm-linux-gnueabihf-g++),调试器须用对应交叉gdb(如/usr/bin/arm-linux-gnueabihf-gdb),并正确设置device type为generic linux device、sysroot路径及kit名称含架构标识。

Qt Creator 里“套件(Kit)”不是直接配置的,而是由 Qt 版本、编译器、调试器三者组合而成 —— 缺一不可,且必须架构一致。
Qt Versions 必须指向交叉编译版的 qmake
交叉编译场景下,qmake 不能用桌面版(比如 /usr/bin/qmake 或 C:\Qt\6.5.0\mingw_64\bin\qmake.exe),必须用你为 ARM/Aarch64/飞腾等目标平台编译出来的那个。
- 路径示例:
/opt/Qt5.9.9/bin/qmake(飞腾)、/home/user/qt5.12.9-armv7/bin/qmake(ARMv7)、/opt/gcc-arm-8.3-2019.03-x86_64-aarch64-linux-gnu/bin/qmake(ARM64) - 添加后,Qt Creator 会自动解析其
QT_VERSION和目标架构;若显示 “unavailable”,右键该条目 → “Show Details”,重点看 “ABI” 是否匹配(如arm-linux-gnueabihf或aarch64-linux-gnu) - 别信“Auto-detect”——它只扫系统 PATH 和常见安装路径,几乎找不到交叉编译的
qmake
Compilers 要选对交叉编译器二进制文件
编译器类型必须和 qmake 的 ABI 完全对应,否则 Kit 会标黄或报 “compiler not set”。
- ARMv7(软浮点/硬浮点):用
arm-linux-gnueabihf-g++,不是g++ - ARM64:用
aarch64-linux-gnu-g++,不是arm-linux-gnueabihf-g++ - 飞腾(aarch64):确认是
gcc-linaro-7.5.0-aarch64-linux-gnu这类工具链里的g++,而非 x86_64 主机的g++ - 验证方法:
file /path/to/arm-linux-gnueabihf-g++输出应含 “ARM aarch64” 或 “ARM architecture”
Debuggers 需要目标平台兼容的 gdb
本地 gdb 无法调试 ARM 程序;必须用交叉 GDB,且版本建议 ≥ 7.10(低版本不支持某些 ARM 指令断点)。
- 常见路径:
/usr/bin/arm-linux-gnueabihf-gdb(Debian/Ubuntu)、/opt/fsl-imx/.../arm-poky-linux-gnueabi-gdb(Yocto)、/opt/gcc-arm-8.3-.../bin/aarch64-linux-gnu-gdb - 若系统没装,先装:
sudo apt install gdb-multiarch(通用)或sudo apt install arm-linux-gnueabihf-gdb(专用) - Qt Creator 不校验 GDB 是否真能连目标板,只检查路径是否存在 + 是否可执行;实际调试失败常因 GDB server(如
gdbserver)没在开发板上运行或端口不通
Kit 页面里组合时最容易忽略的三点
填完 Qt Version、Compiler、Debugger 后,Kit 仍可能标红/黄,问题往往藏在这三个地方:
- “Device type” 必须选 “Generic Linux Device”,不能选 “Desktop”(哪怕你在 Linux 主机上跑 Qt Creator)
- “CMake Tool” 留空 —— 交叉编译 Qt 项目基本用
qmake,填了 CMake 会导致构建失败 - “Sysroot” 字段如果非空,必须指向你交叉工具链的 sysroot 目录(如
/opt/gcc-linaro-arm-linux-gnueabihf-7.5.0/sysroot),否则头文件和库链接会出错
Kit 名称建议带架构标识,比如 “Qt5.9.9-armv7hf”、“Qt5.12.9-aarch64”,避免后期混淆。一旦 Kit 左侧出现绿色勾,说明三者已对齐;但真正可靠要等到程序拷到板子上跑起来 —— 因为 libstdc++.so.6 版本不匹配这类问题,Kit 配置阶段完全无法检测。











