qmake -v 命令失败说明path未生效，需手动将qt安装路径加入环境变量；qt creator中qmake标红可能因权限不足、架构错配（arm64系统须用aarch64版）或用户权限隔离；kit“unconfigured”需手动配置编译器和调试器；webengine模块缺失需通过maintenancetool安装。
qmake -v 命令失败说明PATH没生效
终端里敲 qmake -v 报 command not found，就说明系统根本找不到 qmake，不是 Qt Creator 的问题，是环境变量没配对。麒麟系统默认不自动注入 Qt 安装路径，哪怕你装了 /opt/Qt/6.5.3/gcc_64/bin/qmake，也得手动加进 PATH。
执行以下命令验证并修复：
- 运行
echo $PATH | grep Qt，没输出就说明没加进去 - 编辑
~/.bashrc或~/.profile，追加一行：export PATH="/opt/Qt/6.5.3/gcc_64/bin:$PATH"（路径按你实际安装位置调整） - 执行
source ~/.bashrc，再试qmake -v—— 应该能打出版本号
Qt Versions 里手动添加 qmake 路径仍标红
即使 qmake -v 成功，Qt Creator 的 Kits → Qt Versions 页面里手动添加 /opt/Qt/6.5.3/gcc_64/bin/qmake 后仍显示红色或 “invalid”，常见原因有三个：
Qt Creator 18.0.2
下载
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
-
qmake文件权限不足：运行ls -l /opt/Qt/6.5.3/gcc_64/bin/qmake，确认输出含-rwxr-xr-x；若无x位，用chmod +x /opt/Qt/6.5.3/gcc_64/bin/qmake - 架构错配：麒麟 V10 SP1+ 是 ARM64 系统，
file /opt/Qt/6.5.3/gcc_64/bin/qmake输出必须含aarch64；若显示x86-64，说明装错了安装包，得重下 ARM64 版 - 用户权限隔离：root 安装的 Qt，默认普通用户可能无读取权限；运行
sudo chmod -R a+rX /opt/Qt或改用sudo chown -R $USER:$USER /opt/Qt
Kit 显示 “unconfigured” 或找不到编译器
Qt Versions 有了，但 Kit 还是灰色或提示 “unconfigured”，说明编译器、调试器没对上。Qt Creator 不会自动把 GCC 和 qmake 绑定，得人工配齐三件套：
- 先去 Kits → Compilers，点
Auto-detect；若没扫出 GCC，手动添加：C编译器填/usr/bin/gcc，C++填/usr/bin/g++ - 再去 Kits → Debuggers，确保
/usr/bin/gdb已识别；没的话手动加，路径别写错 - 最后回到 Kits → Kits，点
Add，名称随便写，Qt version选你刚加好的那个，Compiler和Debugger分别选上面配好的项
维护工具里没装 WebEngine 模块却报 unknown module
项目 .pro 文件里写了 QT += webenginewidgets，但构建时报 Unknown module(s) in QT: webenginewidgets，不是 Kit 配置问题，是模块压根没装：
- 启动
MaintenanceTool（通常在 Qt 安装根目录），选 “Add or remove components” - 展开你当前 Qt 版本（如
Qt 6.5.3），找到Qt WebEngine子项，勾选它（注意不是 “WebEngine Core”，要选带Widgets的完整组件） - 安装完重启 Qt Creator —— 不用重新注册
qmake，但 Kit 里的 Qt 版本条目可能需要右键 → “Rescan”
最常被跳过的其实是 file qmake 那一步：ARM64 系统上跑 x86-64 的 qmake 不会报错，而是静默段错误，Qt Creator 就卡在 “invalid” 上不动，连日志都不吐。动手前先看架构，比反复重启 Qt Creator 有用得多。
