VSCode/PlatformIO多文件编译报错：变量重复定义问题求助

问题原因 #

你在var.h中直接定义了int variable;，虽然添加了头文件防护（#ifndef或#pragma once），但这类防护仅能避免单个源文件重复包含同一个头文件，无法阻止多个不同的源文件（比如var.cpp和main.cpp）分别包含头文件后，各自生成一个variable的定义副本。链接器合并所有目标文件时，会发现多个同名变量定义，从而触发该错误。

解决方案：分离变量的声明与定义 #

将变量的声明放在头文件，实际定义放在对应的cpp文件中，确保整个程序中变量只有一个实例。

修改后的代码 #

var.h

#ifndef var_h
#define var_h

#pragma once
#include <Arduino.h>

// 声明变量，告诉编译器该变量在其他文件中定义
extern int variable;

void set_var(int number);

#endif // var_h

var.cpp

#include "var.h"

// 实际定义变量，整个程序仅存在这一个实例
int variable;

void set_var(int number){
    variable = number;
}

main.cpp和platformio.ini无需修改。

补充说明 #

如果不需要跨文件访问该变量，也可以将变量定义为static int variable;并放在cpp文件中，但这种方式会限制变量的作用域仅在当前编译单元内，不适合需要跨文件调用的场景。

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