Arduino未重载函数却报cannot be overloaded编译错误如何解决

• 该问题是Arduino IDE内置预处理器的已知bug导致，和代码本身的逻辑合法性无关。
• Arduino预处理器在将.ino源码转换为标准C++代码前，会自动扫描全局函数生成函数原型，但其词法分析逻辑存在缺陷：当结构体/类内部定义了匿名枚举时，预处理器无法正确识别后续的成员函数属于结构体作用域，会错误地将X::update()识别为全局函数，重复生成多次相同的函数声明。
• 编译器收到重复的update()函数声明后，判定你尝试对返回值、参数列表完全相同的函数进行非法重载（C++不允许签名完全一致的函数重复定义），就会抛出对应的报错。

方法1：给匿名枚举添加名称（改动最小） #

只需要给结构体内部的匿名枚举指定任意自定义名称，就能让预处理器正确识别作用域，避免生成重复声明：

struct X {
    enum MyEnum : byte { // 给枚举添加任意名称即可
        foo,
        bar
    };
    
    void update() {}
};

void setup() {}
void loop() {}

方法2：将结构体定义移到独立头文件 #

Arduino预处理器只会对.ino后缀的主文件执行自动生成函数原型的逻辑，不会处理.h/.cpp文件。你可以新建X.h头文件存放结构体定义，再在主程序中引入#include "X.h"，即可完全避开该预处理器bug。

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