确认 cmake-gui 可用：Windows 运行 where cmake-gui 或手动访问 C:\Program Files\CMake\bin\cmake-gui.exe；Linux/macOS 执行 which cmake-gui；若无输出，需按系统补装对应 GUI 包（如 Ubuntu 装 cmake-qt-gui，macOS 用 brew install --cask cmake）。
安装完 CMake 后，cmake-gui 不会自动出现在开始菜单或 PATH 中（尤其 Windows 上未勾选“Add to PATH”时），必须确认它已正确安装并能被系统识别。
怎么确认 cmake-gui 确实可用？
不是所有安装方式都默认包含 GUI 工具：
- Windows 官方
.msi安装包默认带cmake-gui.exe，但需在安装时勾选 “Add CMake to the system PATH for all users” 或手动找到安装目录下的bin/cmake-gui.exe（如C:\Program Files\CMake\bin\cmake-gui.exe） - Linux 通过包管理器安装（如
apt install cmake）通常不含 GUI，得额外装cmake-qt-gui（Ubuntu/Debian）或cmake-gui（Fedora） - macOS 用 Homebrew 安装的
cmake默认不含 GUI；需运行brew install --cask cmake才会把cmake-gui应用放进/Applications - 命令行验证：终端执行
which cmake-gui（Linux/macOS）或where cmake-gui（Windows CMD）；若无输出，说明不可直接调用
cmake-gui 启动失败常见报错和应对
双击图标或命令行启动时卡住、闪退、报错，多数源于依赖缺失或路径混乱：
- Linux 报
error while loading shared libraries: libQt5Core.so.5：缺 Qt5 运行库，装libqt5core5a和libqt5gui5（Ubuntu） - Windows 报 “无法启动此程序，因为计算机中丢失 Qt5Core.dll”：说明安装包不完整，重装官方
.msi版本，勿用免安装 ZIP 包 - macOS 报 “cmake-gui is damaged and can’t be opened”：系统安全限制，右键 App → “打开”，绕过 Gatekeeper
- GUI 界面空白或按钮无响应：可能是显卡驱动或 Wayland 环境问题（Linux），尝试在 X11 下运行：
export GDK_BACKEND=x11 && cmake-gui
第一次打开 cmake-gui 必须填对的两个路径
界面里只有两个输入框真正影响后续流程，填错会导致 Configure 失败或覆盖源码目录：
-
Where is the source code:必须指向含CMakeLists.txt的**最外层目录**，不能是子目录，也不能是空目录 -
Where to build the binaries:必须是**完全空的新目录**（不能与源码同目录，也不建议嵌套在源码内）；例如源码在/home/user/project，构建目录就设为/home/user/project/build - 点
Configure前，如果底部状态栏提示 “Source directory does not contain a CMakeLists.txt”，说明第一个路径错了 - 如果弹出 “The binary directory is not empty. Would you like to use it anyway?” —— 别点 Yes，清空该目录再试，否则缓存冲突导致配置异常
生成器（Generator）选错会导致构建失败
Configure 弹窗里选的生成器，决定了后续生成什么类型的工程文件，也绑定了编译器链：
- Windows 上没装 Visual Studio 却选了
Visual Studio 17 2022：Configure 直接失败，报 “Could not find compiler set in environment variable CC” - 想用 Ninja 却没装
ninja：即使选了Ninja生成器，Configure 也会卡住或报 “ninja executable not found” - Linux/macOS 默认生成
Unix Makefiles，但如果你装了ninja，可手动选Ninja加速构建（比 make 快） - 跨架构需求（如编译 ARM64）：仅靠 GUI 无法指定，必须用命令行加
-A ARM64；GUI 里没有对应选项
真正容易被忽略的是：CMake GUI 不保存你每次选的生成器，下次打开还得重新选；而且一旦点了 Generate，它不会自动调用构建命令——你仍需手动进构建目录执行 cmake --build . 或打开生成的 VS 解决方案。GUI 只管“生成”，不管“编译”。
