cmake-gui 是用于生成构建系统文件（如 Visual Studio 解决方案、Makefile、Ninja 脚本）的配置界面，而非启动或编译项目；它要求源码目录与全新空构建目录严格分离，配置需先 Configure 成功再 Generate，生成后仍需用对应工具（VS、make、ninja）实际编译。
直接说结论：cmake-gui 不是用来“启动项目”的，它是用来**生成构建系统文件**（比如 Visual Studio 解决方案、Makefile、Ninja 构建脚本）的配置界面。你不能跳过它去编译 C++ 项目，但也不能指望它帮你编译或运行代码。
源码目录和构建目录必须分开
这是最容易出错的第一步。cmake-gui 要求你明确指定两个路径：
-
Where is the source code：指向含CMakeLists.txt的根目录（不能是空目录，也不能是 build 目录本身） -
Where to build the binaries：必须是一个**全新、完全为空**的目录（比如项目根目录下的build子目录）
如果构建目录里已有 CMakeCache.txt 或 CMakeFiles/，configure 很可能失败或读取旧缓存导致配置不生效。删掉整个构建目录再试，比反复点 configure 更可靠。
Configure 失败时先看错误信息框和底部状态栏
点 Configure 后弹出的窗口里选生成器（如 Visual Studio 17 2022 或 Ninja），点 Finish。失败时别急着重选生成器——先看主窗口底部状态栏和弹出的红色错误框，常见问题有：
-
Could not find a package configuration file provided by "OpenCV"：说明find_package(OpenCV)找不到，得手动设OpenCV_DIR变量为 OpenCV 安装目录下的lib/cmake/opencv4（或opencv3）路径 -
The CMAKE_C_COMPILER is not a full path：通常是因为没装对应工具链（比如选了 VS 生成器但没装 Visual Studio 或没勾选 C++ 工作负载） - 空白错误或卡住：关掉 cmake-gui，确认构建目录清空，再重开；Windows 上有时杀掉后台残留的
cmake.exe进程也有用
修改变量要用 Grouped + Advanced 模式
默认界面只显示常用变量。要改 CMAKE_BUILD_TYPE（Linux/macOS）、CMAKE_INSTALL_PREFIX、第三方库路径等，必须勾选顶部的 Grouped 和 Advanced 复选框。否则变量根本不会显示。
改完变量后必须再点一次 Configure（不是 Generate），让 CMake 重新解析依赖关系。只有 Configuring done 出现在底部，才能点 Generate。
Generate 后不等于能编译，只是生成了构建系统
Generate 成功只代表生成了 .sln、Makefile 或 build.ninja 等文件。下一步是：
- Windows + VS 生成器 → 去构建目录打开
xxx.sln，在 VS 里按常规方式编译 - Linux/macOS + Makefile → 终端进构建目录，执行
make或make -j$(nproc) - Ninja → 执行
ninja或ninja install（如果有 install 规则）
cmake-gui 本身不调用编译器，也不处理 make install 或链接错误。那些都属于生成后的构建阶段，和 cmake-gui 无关。
最常被忽略的一点：CMakeLists.txt 里写的 find_package() 是否真能找到对应库，不取决于你有没有安装那个库，而取决于 CMake 能否通过 xxx_DIR 变量或环境变量定位到它的 Config.cmake 文件。路径写错、大小写不一致、多了一层子目录（比如写了 lib/cmake/opencv 但实际是 lib/cmake/opencv4），都会静默失败。
