科技 · 实用指南
CMake 提示生成器不匹配？删缓存前先证明构建树归属
固定失败的源目录/构建目录组合，读取缓存生成器与前端设置；只有隔离配置、原生构建和测试全部通过后，才处置旧树。
CMake 的生成器不匹配表示现有构建树记住了与本次配置请求不同的生成器。这是构建树身份冲突，不是重命名或删除 CMakeLists.txt 的理由。
先保留命令和缓存，确认命令行、环境变量、预设、kit 或 IDE 谁选择了新生成器；记录需要复现的设置后，再使用独立构建树或审慎执行 --fresh。
固定冲突的源目录与构建目录
保存准确命令、工作目录、环境、预设与 IDE 日志，分别解析源目录和构建目录；不要通过修改 CMakeLists.txt 解决缓存身份冲突。
复制或计算 CMakeCache.txt 哈希，并记录 GENERATOR、PLATFORM、TOOLSET、HOME_DIRECTORY、编译器与有意设置的 -D 值。
找出生成器的实际归属者
比较显式 -G、CMAKE_GENERATOR、活动配置预设、kit、CMake Tools 设置、toolset 与 platform。应只有一个权威决定目标配置，偶然覆盖也要先记录再移除。
若旧树来自另一机器、容器、检出目录或 IDE 版本，应把它作为证据而非默认复用对象；不同生成器的原生构建文件不能混用。
选择可逆的恢复边界
优先使用 -S、-B 与目标生成器创建新构建目录，只恢复已审阅的缓存选项，并保留旧树用于对比与回滚。
只有无法建立新树且已保存设置时才用 --fresh 或删除 CMakeCache.txt/CMakeFiles。--fresh 需要 CMake 3.24 或更高；修复不应删除源树。
证明配置、构建与测试
保存成功配置的完整记录，核实新缓存中的源树、生成器、platform、toolset 与编译器，然后用 cmake --build 调用匹配的原生工具。
运行项目测试并检查二进制、库、包或 compile database；与旧缓存比较关键选项，单凭配置退出码不能验收。
有意识地退役污染树
只有替代树通过验收后，才归档或删除旧构建树，并统一 CI、预设与 IDE 的源/构建边界和生成器权威。
不改输入再次配置，必须保持同一生成器且不出现无解释的全量重建；保留归属清单供下次工具链或 IDE 变更使用。
