为何仅使用Arduino便携版编译ESP32开发板时出现错误？

解决方案 #

1. 重新下载完整的ESP32工具链 #

• 找到便携版IDE中ESP32工具链的路径：c:\users\pasca\downloads\arduino-1.8.19-windows\arduino-1.8.19\portable\packages\esp32\tools\xtensa-esp32-elf-gcc
• 删除整个xtensa-esp32-elf-gcc文件夹
• 重启Arduino IDE，打开工具>开发板>开发板管理器，找到ESP32开发板包，点击「更新」重新下载工具链

2. 从正常工作的常规版IDE复制工具链 #

• 在能正常编译ESP32的常规版IDE中，找到工具链路径（一般为C:\Users\<你的用户名>\AppData\Local\Arduino15\packages\esp32\tools\xtensa-esp32-elf-gcc）
• 将对应版本的xtensa-esp32-elf-gcc文件夹完整复制到便携版IDE的portable\packages\esp32\tools\目录下，覆盖原有文件

3. 调整便携版IDE的存放路径 #

• 当前便携版IDE放在downloads目录可能存在权限限制，将整个arduino-1.8.19文件夹移动到非系统盘（如D盘根目录），再重启IDE尝试编译

错误原因 #

该错误通常是由于ESP32的XTENSA GCC工具链下载不完整，或者便携版IDE所在路径存在权限/特殊字符限制，导致编译器无法定位C++标准库的配置文件bits/c++config.h。

问题背景 #

使用Arduino便携版IDE（按官方教程配置）编译Arduino AVR、SAM开发板的空代码可正常运行，但编译ESP32开发板时出现以下错误：

c:\users\pasca\downloads\arduino-1.8.19-windows\arduino-1.8.19\portable\packages\esp32\tools\xtensa-esp32-elf-gcc\gcc8_4_0-esp-2021r2-patch3\xtensa-esp32-elf\include\c++\8.4.0\cstdlib:41:10: fatal error: bits/c++config.h: No such file or directory

已通过ESP32官方索引添加开发板支持，常规版IDE编译ESP32正常。

测试用空代码：

void setup() {
// put your setup code here, to run once:
}
void loop() {
// put your main code here, to run repeatedly:
}

内容的提问来源于stack exchange，提问作者Pascal.igst