qmake -v失败说明PATH未生效，需将Qt的bin路径加入环境变量并验证；Qt Creator不自动扫描qmake，须手动添加其路径；Kit中Qt版本显示invalid多因编译器或调试器不匹配；麒麟系统需确认架构一致；macOS上Qt Creator不在/Applications而位于用户目录。
qmake -v 命令失败，说明PATH没生效
这是最常见也最容易被忽略的第一道坎。Qt Creator不依赖图形界面路径，它靠系统环境变量找qmake。如果终端里执行qmake -v报command not found，那IDE根本不会去扫描Qt安装目录。
- 先确认Qt实际安装路径，比如
/opt/Qt/6.5.3/gcc_64/bin/qmake或/home/username/Qt/6.5.3/mingw_64/bin/qmake - 把该路径加进
~/.bashrc（Linux/macOS）或系统环境变量（Windows），注意是bin目录，不是lib或include - 执行
source ~/.bashrc（或重启终端），再试qmake -v——必须看到版本号输出才算过关 - Mac用户特别注意：
/etc/profile对GUI应用不一定生效，建议改~/.zprofile（zsh默认）或用launchctl setenv PATH注入GUI会话
Qt Versions列表为空，但qmake路径存在
即使qmake -v成功，Qt Creator仍可能不认——它不会自动扫描所有qmake，只认你手动添加或它“自动检测”到的那些。
- 打开
Tools → Options → Kits → Qt Versions，点击Add - 不要选目录，直接指向
qmake可执行文件，例如：/opt/Qt/6.5.3/gcc_64/bin/qmake - 添加后点
Apply，右侧会显示Qt版本号和MKSPEC（如linux-g++），若显示invalid，大概率是架构错配或权限问题 - 麒麟系统ARM64用户务必用
file /path/to/qmake确认输出含aarch64；x86_64版在ARM机器上静默失效，无任何错误提示
Kit里Qt版本显示“invalid”，但qmake能运行
这通常不是Qt本身的问题，而是Kit三要素绑定断裂：Qt Version、Compiler、Debugger中任一环节不匹配或不可读。
- 检查
Compilers页签：确保GCC/MinGW路径正确，且g++ --version能执行；路径含空格或中文会导致Qt Creator跳过识别 - 检查
Debuggers页签：GDB必须和编译器ABI一致，MinGW配GDB，MSVC配CDB，Clang配LLDB；gdb --version要能返回结果 - 麒麟系统用户注意：若用了毕昇编译器（
bisheng-g++），必须安装对应Qt模块（非标准gcc_64目录），且Kit中Compiler和Qt Version需严格对应同一构建链 - 权限隔离常见于root安装+普通用户启动：用
sudo -u $USER ls -l /opt/Qt验证是否可读；必要时sudo chmod -R a+rX /opt/Qt
Mac上Qt Creator图标“消失”，但实际已安装
这不是Bug，是Qt安装机制和macOS应用分发方式的差异导致的视觉错觉。Qt Creator不会像普通App那样出现在/Applications，而是放在用户目录下。
- 默认路径是
/Users/yourname/Qt/Tools/QtCreator/bin/Qt Creator.app或/Users/yourname/Qt/[version]/Qt Creator.app - Spotlight（Cmd+Space）搜
Qt Creator，看到绿色原子图标才是真身；若只搜到文件夹或文本，说明索引未更新，重启Mac或执行mdutil -E /重建Spotlight索引 - 拖拽到Dock时，右键Dock图标→
Options → Keep in Dock，否则重启后消失 - 若从Launchpad启动失败，尝试终端执行：
open "/Users/yourname/Qt/Tools/QtCreator/bin/Qt Creator.app"
