最近折腾PlatformIO+VSCode，编译时报找不到库文件：
fatal error: pins_arduino.h: No such file or directory
百思不得其解，问了GPT老师才知道，错误并非来自用户代码，而是 Arduino core 内部文件（如 esp32-hal-gpio.h、HardwareSerial.cpp）在编译时无法找到 pins_arduino.h，导致整个构建过程失败。
按照G老师的说法，这是 PlatformIO 当前版本与 Arduino-ESP32 v3.x 之间的兼容性问题。
在 Arduino-ESP32 v3.x 中，pins_arduino.h 被放置在各个 board 对应的 variants/<board> 目录下，依赖构建系统正确注入 variant 的 include 路径。而在 PlatformIO 的 espressif32@6.12.0 平台中，针对 seeed_xiao_esp32c3，该 variant 路径并未被正确加入编译器的 include search path，导致 Arduino core 自身也无法找到 pins_arduino.h。
手动指定版本后问题解决：
回退到 Arduino-ESP32 v2.x 对应的平台版本，例如：
[env:seeed_xiao_esp32c3]
platform = espressif32@6.5.0
board = seeed_xiao_esp32c3
framework = arduino
在该版本组合下，variant 注入逻辑正常，pins_arduino.h 能被正确找到，最小示例即可顺利编译。
也可以通过手动指定：
board_build.variant = seeed_xiao_esp32c3
来绕过问题，但在 v3.x 下仍可能遇到其他尚未完全适配的细节，不作为长期推荐方案。