Qt Creator在Linux上怎么配置环境？-C++-PHP中文网

qmake能运行、gcc/g++被识别、kit自动匹配三者同时成立才算qt creator环境配好；否则易出现编译报错、头文件缺失或“could not find qt platform plugin”等运行时错误。

qt creator在linux上怎么配置环境？

qmake 能跑起来、gcc 和 g++ 被识别、Kit 能自动匹配——这三件事都成立，才算真正配好 Qt Creator 环境。否则编译报错、找不到头文件、运行时提示“Could not find Qt platform plugin”，大概率是环境链断在某个环节。

别急着打开 Qt Creator，先在终端验证基础工具链是否就位：

qmake --version 必须输出版本号（如 Qt 5.12.9），否则 Qt 库或 qmake 本身没装对；
gcc --version 和 g++ --version 需返回有效信息，Ubuntu/Debian 用户推荐用 sudo apt install build-essential 一次性补全；
如果用的是源码编译的 Qt（比如交叉编译场景），qmake 路径可能不在 $PATH 中，得手动加进 ~/.bashrc：比如 export PATH=/home/user/qt-arm/bin:$PATH，然后 source ~/.bashrc；
执行 which qmake 和 which gcc，确保路径不为空且指向你预期的位置。

Qt Creator 不会自动扫描所有 gcc 或 qmake，必须显式添加：

Linux installer

先解析安全源，运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

打开 工具 → 选项 → 构建与运行 → 编译器，点击“添加” → “GCC” → 填写 gcc 和 g++ 的绝对路径（如 /usr/bin/gcc）；
同页切换到“Qt 版本”，点击“添加”，选择你本地的 qmake 可执行文件（不是 qmake-qt5 或软链接，而是真实路径，如 /usr/lib/x86_64-linux-gnu/qt5/bin/qmake）；
关键细节：Qt 版本名会自动生成（如 “Qt 5.12.9 (GCC 11.4.0)”），但若显示 “Unknown” 或空白，说明 qmake 返回了异常输出（常见于权限不足或缺失 libstdc++.so）；
不要跳过“调试器”配置——哪怕只做 Release 构建，也建议添加系统自带的 gdb（路径通常是 /usr/bin/gdb），否则 Kit 创建时可能失败。

Kit 是 Qt Creator 的“构建上下文”，三个组件缺一不可，且必须兼容：

进入 构建与运行 → Kits，点击“添加”，名称可填 “Desktop Qt 5.12.9 GCC”；
“Qt 版本”下拉框选你刚注册的那个；
“编译器”选对应的 GCC 和 G++ 条目（注意：C 和 C++ 编译器要成对，不能混用不同版本）；
“调试器”选你配置好的 gdb；
最容易被忽略的一点：“设备类型”必须选 “Desktop”（哪怕你目标是嵌入式，只要当前在 PC 上开发，这里就不能选 “Generic Linux Device”）；
保存后，新建项目时若 Kit 显示黄色感叹号，鼠标悬停会提示具体缺失项（比如 “No debugger set” 或 “Qt version not found”）。

如果你的目标是 ARM/Linux（如全志 V853、i.MX6），光有桌面 Kit 不够，Kit 还得绑定交叉工具链：

先确保终端里能直接运行 arm-openwrt-linux-gcc -v，否则 Qt Creator 也无法调用；
在“编译器”页添加新 GCC 时，“ABI”务必选 arm-linux-generic-elf-32bit（或对应你的芯片架构），否则 Kit 无法关联；
Qt 版本注册时，qmake 必须是你为 ARM 编译出的那个（比如 ~/qt-arm/bin/qmake），它内部已硬编码了 CROSS_COMPILE=arm-openwrt-linux-；
环境变量 STAGING_DIR 会影响 qmake 查找 sysroot，但它**不会**被 Qt Creator 自动继承——必须在 Kit 的 “环境” 栏里手动添加，否则 #include <sys></sys> 会报错；
验证方式：新建一个空项目，右键“构建目录” → “在终端中打开”，执行 qmake -query，检查 QT_SYSROOT 是否指向你期望的 STAGING_DIR 路径。