ESP32的官方文档简直文盲写的，乱七八糟不得要领。

推荐使用环境：Ubuntu+vscode。

最好创建一个专门的账号，就搞ESP32，避免开发环境相互污染。

假设当前有一个基本的ubuntu，安装了基本的vscode+中文插件。

1、安装clangd(同时需要sudo apt-get安装clang LLVM之类的),better c++ syntax和微软的cmake tools。这是绝大多数教程都忽略的一步。如果没有先安装这几个插件，后续将无法实现代码跳转——除非你对vscode足够熟悉能自己手动配置

2、按照立创开发板项目的这个操作步骤安装esp32的插件和工具链。安装完这一步，正常可以进行编译和下载运行。安装时建议选择在线安装，尽量减少自己对工具链的操作。注意安装前提是已经执行了第一步。https://wiki.lckfb.com/zh-hans/esp32s3r8n8/

3、调试：参考https://blog.csdn.net/qq_45746070/article/details/143995290描述的“方法4”，应该就可以调试了。如果还不行，则需要从下图的路径打开openocd的server。调试的时候可以从vscode的小虫子那里进入，选择launch，而不是默认的那个调试配置文件。

4、注意不要用cmake tools这个插件配置什么东西，这货的存在存粹就是为了让代码解析、跳转的工具链能运作起来，它本身不参与esp32的任何有意义的动作，反而会有副作用。

如果工具链安装过程中出现意外，通常的解决办法是删除($HOME)/.espressif目录、($HOME)/esp目录，以及vscode的所有插件(可以考虑直接删($HOME)/.vscode目录)，重新来过。

如果这个帖子令你受益，请跟一句“ESP官方文档垃圾”