cmake缓存未更新导致配置不生效，需先检查cmakecache.txt；清除缓存可用删build目录、删cmakecache.txt或vs code一键命令；覆盖变量推荐-d参数或force；避免缓存可改用not defined判断。
修改了CMakeLists.txt里的缓存变量值，重新运行cmake却还是旧配置，编译结果没变——这不是代码写错了，而是CMake缓存机制在“记住”你上次的选择，且默认拒绝被覆盖。
确认问题根源：先看CMakeCache.txt是否真被改了
打开你的构建目录（比如build/Debug），找到CMakeCache.txt文件，用文本编辑器打开，搜索你要修改的变量名（如BUILD_TESTING或INSTALL_DIR）。如果该变量仍显示旧值，说明缓存未更新，后续所有操作都无效。
这一步必须做。不查CMakeCache.txt就动手删文件或加FORCE，等于蒙眼修电路。
清除缓存的三种实操路径
方法一：暴力清空（最彻底，适合路径变更、工具链重装、跨机器迁移）
直接删除整个build文件夹 → 重启VS Code（或终端）→ 重新执行cmake -B build或点击CMake插件的“Configure”按钮。
【注意】删build会丢失所有中间编译产物（.o/.a/.elf），下次构建耗时显著增加，但100%规避缓存残留风险。
方法二：精准清除（保留编译中间文件，仅重置配置）
关闭所有IDE和构建进程 → 找到build/CMakeCache.txt → 删除该文件 → 重新配置CMake。
这个操作不会影响build/Debug/obj等已编译对象，仅强制CMake重新探测编译器、库路径、语言特性等。适用于仅修改了option或set(CACHE)参数的日常调试。
方法三：一键清理（VS Code用户专属捷径）
Ctrl+Shift+P → 输入CMake: Delete Cache and Reconfigure → 回车执行。
该命令等价于删除CMakeCache.txt + 触发完整重配置，不删.obj也不删build目录结构。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
覆盖已有缓存变量的两种可靠写法
第一步：在CMakeLists.txt中定位原缓存变量定义语句，例如：
set(ENABLE_LOGGING ON CACHE BOOL "Enable debug logging")
第二步：选择以下任一方式覆盖（二者不可共存）：
方法一：命令行强制注入（推荐用于CI/脚本/临时验证）
在终端中执行：cmake -B build -DENABLE_LOGGING=OFF
【-D参数优先级最高，它在CMake读取CMakeCache.txt之前生效，能绕过所有缓存粘性】
方法二：源码内强制覆盖（仅限开发阶段自用）
将原语句改为：set(ENABLE_LOGGING OFF CACHE BOOL "Enable debug logging" FORCE)
注意：FORCE必须紧贴在类型和说明字符串之后，缺一不可；且该写法会让每次cmake都强行覆盖，失去用户自定义能力，上线前务必删掉FORCE。
避开缓存陷阱的替代方案
如果你只是想让某个开关随CMakeLists.txt修改即时生效，根本不想碰缓存——那就别用CACHE。
把：set(USE_FAST_MATH ON CACHE BOOL "Enable fast math")
换成：if(NOT DEFINED USE_FAST_MATH) set(USE_FAST_MATH ON) endif()
这样变量只在首次运行时取默认值，后续修改CMakeLists.txt立刻生效，完全不写入CMakeCache.txt。
这招适合内部逻辑开关、条件编译宏等无需用户干预的配置项。但记住：它无法通过cmake-gui或-D参数修改，属于纯代码控制流。
