这问题我太熟了，核心是你搞混了头文件保护的作用和C++链接器的单定义规则（ODR），咱们一步步拆解：

1. 先搞懂include guard到底防什么？ #

你加的#ifndef SOMETHING_H这类保护，只是防止单个源文件（比如Main.cpp）重复包含同一个头文件——比如你在Main.cpp里不小心写了两次#include "Something.h"，它能避免头内容被重复编译一次。但如果有多个源文件（比如Main.cpp和Sensor.cpp）都#include "Something.h"，每个源文件在编译成独立的目标文件（.o）时，都会把头文件里的变量定义int foo = 0;编译到自己的目标文件里。

2. 链接器的“零容忍”：单定义规则 #

当Arduino IDE调用链接器把所有目标文件合并成最终固件时，它会严格遵循C++标准的单定义规则：全局变量只能有一个定义。这时候链接器发现多个目标文件里都有foo的定义，不管你有没有在那个源文件里实际使用它，都会直接抛出multiple definition错误。

你之前用的芯片链接器可能是“宽松模式”，允许这种重复定义（有些嵌入式编译器为了兼容旧代码会默认放宽检查），但ESP32用的是标准GCC工具链，严格遵守C++规则，所以就踩坑了。

3. 正确的解决方案（分两种场景） #

场景1：变量仅在Something.cpp内部使用 #

这时候完全不需要在头文件里提这个变量，直接在Something.cpp里把它定义成static的：

// Something.cpp
static int foo = 0; // static把变量的作用域限制在当前编译单元（即这个.cpp文件）

void someFunction() {
  foo++; // 正常使用，其他源文件看不到这个变量
}

static在这里的作用是“隐藏”变量，让它只属于当前CPP文件，其他源文件哪怕include了Something.h，也不会感知到这个变量的存在，自然不会有多重定义问题。

场景2：变量需要跨文件共享 #

就是你已经用对的模式：

// Something.h
#ifndef SOMETHING_H
#define SOMETHING_H
extern int foo; // 仅声明，告诉编译器这个变量在其他地方定义
#endif

// Something.cpp
int foo = 0; // 唯一的定义，链接器会把所有extern指向这里

总结一下误区 #

你以为“变量只在Something.cpp里用，头文件定义就没事”，但只要其他源文件include了这个头，就会在自己的目标文件里生成一份变量定义——哪怕你没在那个源文件里用它，链接器也会揪出来。所以非跨文件使用的变量，绝对不要放到头文件里，直接在CPP里用static定义就好。

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