C/C++项目编译出现multiple definition问题

先介绍一下 static 修饰词在 C/C++ 中的作用：

1. 隐藏：修饰全局变量/函数时，该变量/函数只能在本文件中调用，对其他文件不可见。

2. 保持局部变量值的恒定：修饰局部变量时，其只初始化一次，生命周期和全局变量一致（一般局部变量保存在栈中，全局变量保存在全局数据区），直到程序结束才释放。

3. static修饰的变量默认初始化为0。

c++独有：

     4. 修饰类的数据成员，表明该类所有对象这个数据成员都只有一个实例，即为所有对象共有。

     5. 修饰类成员函数，表明这个静态成员函数，只能访问它的参数、类的静态数据成员和全局变量。

C/C++项目编译出现multiple definition问题总结：

起因：多个c(c++)文件同时引用了同一个.h文件，导致其被包含至多个目标文件中，在链接时，.h文件中定义的变量/函数将会出现重复定义的错误。

分析：C语言规定 “一个变量可以多次声明但只能定义一次”

解决办法：C中，可以通过.h文件开头添加条件编译解决，但在C++中不管用，因为C++中 #ifndef 的作用域仅限一个文件，可以通过在变量/函数前添加static解决。

总结：弄清声明和定义的区别，尽量避免在.h文件中定义变量、函数。

---

补充：如果你没有以上问题，即 1.既有规范的条件编译、2.又没有重复定义变量/函数，仍然出现了multiple definition，考虑是否是gcc版本问题。

        贴上一个大佬的帖子。

【GCC编译优化系列】这种让人看不懂的multiple-definition真的有点让人头疼（RT-Thread技术论坛优秀文章） - 腾讯云开发者社区-腾讯云 (tencent.com)

        这种情况是gcc高版本（例如10.0以上）的默认编译选项-fcommon不开启了，你的.h中的变量被识别成了全局变量，自然就“multiple”了。解决办法是在项目的编译选项里加上-fcommon就行了。