本篇主角长这样
适用于产品：ESP32-S3开发板
涉及模块：ESP32-S3芯片 / VSCode / ESP-IDF
一、问题描述
用户在使用 ESP-IDF 编译工程时，遇到 CMake 缓存路径不一致的报错，导致编译无法继续进行。该问题通常发生在移动了项目文件夹，或者从别处拷贝了带 build 目录的工程之后。
典型报错原文如下：
CMake Error: The current CMakeCache.txt directory /path/to/new/build is different than the directory /path/to/old/build where CMakeCache.txt was created.
如果你是因为切换了 ESP-IDF 版本导致报错，请先按本文方法清理缓存；若仍无法解决，建议统一使用教程指定的 v5.4.3 版本 进行开发。
二、问题说明
CMake 在首次配置时会将源码路径、工具链路径等信息写入 build/CMakeCache.txt。当工程被移动、拷贝或重命名后，缓存中记录的旧路径与当前实际路径不一致，CMake 便会拒绝继续配置并报错。常见原因包括：
-
项目文件夹被移动或重命名：缓存中记录的仍是旧目录路径。
-
拷贝了带 build 目录的工程：从其他电脑或目录拷贝工程时一并带入了旧的
build缓存。
三、解决办法
清理 CMake 缓存
1. 方式一：使用 ESP-IDF 插件
(1) 在 VS Code 中打开工程，按下 F1 或 Ctrl+Shift+P 调出命令面板。
(2) 输入并选择 ESP-IDF: Full Clean（全清理）。
(3) 清理完成后，点击底部状态栏的
Build 图标重新编译。
2. 方式二：使用终端命令
(1) 在 VS Code 中按 Ctrl+` 打开终端。
(2) 确保当前路径在项目根目录，执行清理命令：
idf.py fullclean
(3) 执行完毕后，重新编译：
idf.py build
以上清理操作只会删除
build目录下的缓存文件，不会删除你的sdkconfig工程配置。重新编译时，CMake 会自动生成一份匹配当前环境的新缓存。
四、资源下载
若你的资料包丢失或找不到上述文件，可通过以下途径获取：
-
幻尔科技官网在线教程： https://www.hiwonder.com.cn/ -
人工技术支持： 联系你购买设备的店铺客服（淘宝/京东/天猫/官网客服），提供订单号即可免费领取最新版本的资料与驱动。