cmake-gui 是 CMake 安装包自带的 GUI 工具，需正确安装 CMake 并配置 PATH；Source 与 Build 目录必须分离且 Build 目录须为空；首次 Configure 必须选对生成器并确保工具链就绪；修改选项后须重新 Configure 才能生效。
cmake-gui 不是独立安装的程序，它是 CMake 安装包自带的 GUI 工具，只要正确安装了 CMake，它就自动可用。
启动 cmake-gui 的三种常见方式
Windows 上双击开始菜单里的 CMake (cmake-gui) 图标最直接；命令行里输入 cmake-gui 也行（前提是安装时勾选了「Add CMake to PATH」）；macOS 或 Linux 用户通常在终端运行 cmake-gui，若提示 command not found，说明 PATH 没配好，得手动加到 ~/.bashrc 或 ~/.zshrc 里：export PATH="/path/to/cmake/bin:$PATH"。
Source 和 Build 目录必须分开放
这是新手最容易出错的地方：两个路径不能相同，也不能让 Build 目录嵌套在 Source 里。CMake 会拒绝配置并报错 Source and binary directories must not be the same。正确做法是：
-
Source填项目根目录（含CMakeLists.txt的那个） -
Build填一个全新、空的子目录，比如build/或out/ - 如果
Build目录已有内容，Configure可能失败或读取旧缓存，建议清空再试
第一次 Configure 必须选对生成器（Generator）
点击 Configure 后弹出的对话框里，Generator 决定了最终生成什么类型的工程文件。选错会导致后续构建失败：
- Windows 用户常用
Visual Studio 17 2022（对应 VS2022）、Ninja（需提前装好 Ninja） - Linux/macOS 用户一般选
Unix Makefiles或Ninja - 选完别点 Cancel —— 点
Finish才真正触发解析CMakeLists.txt - 如果报错说找不到编译器，说明你没装对应工具链（比如选 VS 却没装 Visual Studio，或没装
build-essential）
修改选项后必须重新 Configure，不是直接 Generate
Generate 按钮只有在配置成功且没有未提交变更时才可点击。常见陷阱：
- 你在 GUI 里改了某个
ON/OFF选项（比如BUILD_TESTS），但没点Configure—— 这些改动不会生效 -
Configure成功后，界面上新出现的变量（比如CMAKE_BUILD_TYPE）才可编辑；之前灰色的变量可能需要先Configure一次才会激活 - 如果
Configure报红，别急着Generate，先看输出栏里具体哪行出错（比如find_package(wxWidgets REQUIRED)找不到，就得先装 wxWidgets 或关掉相关选项）
Configure 或 Generate 阶段。尤其注意 Build 目录必须干净、生成器必须匹配本地环境——这两个点踩中一个，后面全白忙。 
