ESP32在Arduino IDE编译失败求助：空文件也无法编译

错误原因解析 #

你遇到的编译错误中，_Z5setupv和_Z4loopv是C++名字修饰后的符号，对应Arduino框架强制要求的setup()和loop()函数。空文件也编译失败，说明IDE没有自动生成这两个必要的空函数，大概率是文件格式、缓存或核心库出了问题。

具体解决步骤 #

• 确认代码文件格式：确保你的项目主文件是.ino扩展名，而非.txt或其他格式。Arduino IDE仅会对.ino文件自动补充默认的空setup()和loop()函数。
• 清理Arduino缓存：删除缓存目录 /home/mark/.cache/arduino/cores/3dcf1799dbdf581982fe7eebee43e59b/，重启IDE后重新编译。缓存损坏会导致核心文件引用异常。
• 重装ESP32核心库：若缓存清理无效，删除 /home/mark/.arduino15/packages/esp32/ 目录，然后在Arduino IDE的「板管理器」中重新下载安装ESP32核心库（建议选择最新稳定版本）。
• 检查项目结构：确保当前项目文件夹内至少有一个.ino文件，且所有代码文件都在同一项目目录下。无.ino文件的项目无法触发IDE的自动补全逻辑。

原始报错信息 #

/home/mark/.arduino15/packages/esp32/tools/esp-x32/2405/bin/../lib/gcc/xtensa-esp-elf/13.2.0/../../../../xtensa-esp-elf/bin/ld: /home/mark/.cache/arduino/cores/3dcf1799dbdf581982fe7eebee43e59b/core.a(main.cpp.o):(.literal._Z8loopTaskPv+0xc): undefined reference to `_Z5setupv'
/home/mark/.arduino15/packages/esp32/tools/esp-x32/2405/bin/../lib/gcc/xtensa-esp-elf/13.2.0/../../../../xtensa-esp-elf/bin/ld: /home/mark/.cache/arduino/cores/3dcf1799dbdf581982fe7eebee43e59b/core.a(main.cpp.o):(.literal._Z8loopTaskPv+0x10): undefined reference to `_Z4loopv'
/home/mark/.arduino15/packages/esp32/tools/esp-x32/2405/bin/../lib/gcc/xtensa-esp-elf/13.2.0/../../../../xtensa-esp-elf/bin/ld: /home/mark/.cache/arduino/cores/3dcf1799dbdf581982fe7eebee43e59b/core.a(main.cpp.o): in function `_Z8loopTaskPv':
/home/mark/.arduino15/packages/esp32/hardware/esp32/3.1.1/cores/esp32/main.cpp:55:(.text._Z8loopTaskPv+0x1b): undefined reference to `_Z5setupv'
/home/mark/.arduino15/packages/esp32/tools/esp-x32/2405/bin/../lib/gcc/xtensa-esp-elf/13.2.0/../../../../xtensa-esp-elf/bin/ld: /home/mark/.arduino15/packages/esp32/hardware/esp32/3.1.1/cores/esp32/main.cpp:64:(.text._Z8loopTaskPv+0x34): undefined reference to `_Z4loopv'
collect2: error: ld returned 1 exit status

exit status 1

Compilation error: exit status 1

内容的提问来源于stack exchange，提问作者SuperCarrot