删CMakeCache.txt是首选操作，因其存储源码路径、编译器位置、构建工具等关键绝对路径，移动目录或换环境后旧路径失效，直接导致报错；手动编辑风险高，彻底清理应删整个build目录。
CMake 缓存导致报错，基本就是 CMakeCache.txt 里记了旧路径或旧配置，和当前环境对不上。删它，几乎总能解决。
为什么删 CMakeCache.txt 是首选操作
这个文件不是“可选缓存”，而是 CMake 构建状态的快照：记录了源码路径、编译器位置、CMAKE_MAKE_PROGRAM（比如 /usr/bin/gmake 还是 /usr/bin/make）、工具链选择等关键信息。一旦你移动/重命名项目目录、换机器、改系统（Ubuntu → CentOS）、甚至只是复制了一份工程，里面保存的绝对路径就立刻失效。
常见错误提示直接暴露问题根源：
CMake Error: The current CMakeCache.txt directory ... is different than the directory ... where CMakeCache.txt was createdCMake Error: The source "/old/path/CMakeLists.txt" does not match the source "/new/path/CMakeLists.txt"-
Generator: execution of make failed. Make command was: /usr/bin/gmake -f Makefile ...（但新系统只有make）
手动编辑 CMakeCache.txt 风险极高——格式错一个空格、参数间依赖没同步、版本兼容性不匹配，都会让错误更难定位。
删哪个？怎么删才干净
最安全的做法是删整个 build 目录，而不是只删 CMakeCache.txt。因为：
-
build下可能还有CMakeFiles/、临时生成的Makefile、Ninja 构建文件等，它们都依赖缓存一致性 - 有些 IDE（如 VS Code 的 STM32 插件）会在
build/Debug/或build/Release/下生成多层缓存，只删根目录的CMakeCache.txt不够 - 执行
rm -rf build后再mkdir build && cd build && cmake ..，相当于一次干净重启
如果你用的是 VS Code + STM32 插件，直接按 Ctrl+Shift+P → 输入 CMake: Delete Cache and Reconfigure，它会自动清理并触发重新配置，比手动删更快。
删完还报错？检查这几个点
清理缓存后仍失败，说明问题不在缓存本身，而是配置环节出了偏差：
- 确认你当前打开的是正确的工程根目录（比如
S:/stm32/vs_1_free/，而不是旧的vs_1），VS Code 窗口标题或资源管理器路径要核对清楚 - 按
Ctrl+Shift+P→CMake: Select a Kit，重新选一遍工具链（尤其当你装了多个 GCC 版本或 ARM 工具链时） - 检查
CMakeLists.txt是否有硬编码的绝对路径（比如set(STM32_CUBE_PATH "/opt/stm32cubemx")），这类路径不会被缓存清理掉 - 如果用了
vcpkg或自定义 toolchain 文件，确保这些外部依赖的路径在新环境下依然有效
缓存本身没有错，错的是我们把它当成了“永久配置”。每次移动、复制、重命名工程目录，第一件事永远是清 build；跨平台迁移或换编译器，也得清。这不是麻烦，是 CMake 正常工作的前提。
