VS Code重命名ESP-IDF项目文件夹后构建报错解决方案咨询

重命名ESP-IDF项目文件夹后执行构建，会返回如下错误：

构建目录 'd:\githubs\fmc-320\firmware\vscode\test\01-log\build' 配置对应的原项目路径为 'd:\workspace\fmc-320\firmware\vscode\test\01-log'，而非当前项目路径 'd:\githubs\fmc-320\firmware\vscode\test\01-log'，请运行 'idf.py fullclean' 命令后重新开始构建。

不需要新建项目迁移代码，直接通过以下三种方案即可修复，按操作成本从低到高排序：

• 方案1：执行官方全量清理命令
  在项目根目录打开ESP-IDF对应终端，直接执行：
  idf.py fullclean
  执行完成后重新触发构建即可。该命令只会清除build目录下的构建缓存，不会改动业务源码、自定义配置、sdkconfig参数，普通体量项目整个修复过程耗时不超过1分钟。
• 方案2：手动删除构建缓存目录
  如果终端执行命令异常，直接找到项目根目录下的build文件夹整体删除，效果和执行idf.py fullclean完全一致。删除后点击VS Code内的构建按钮，插件会自动基于当前路径生成全新的构建配置。
• 方案3：定向修改缓存文件（适配超大项目，避免全量重编）
  如果项目体量大全量重编耗时过长，可以不删除build目录，直接修改缓存内的路径字段：
  1. 打开build/CMakeCache.txt，全局搜索报错提示的旧项目路径，将所有匹配项替换为当前项目的实际路径
  2. 打开build目录下的sdkconfig缓存文件（不同版本路径为build/sdkconfig或build/config/sdkconfig.json），同样全局替换旧路径为新路径
  3. 保存所有修改后重新触发构建，会直接走增量编译流程，不需要全量重编。

注意：所有路径缓存都存储在build目录下，不要修改项目根目录下的顶层CMakeLists.txt、根目录sdkconfig文件，避免引入额外配置错误。

内容的提问来源于stack exchange，提问作者Daniel H Sagarra