C++引入SAMD_TimerInterrupt外部库出现多重定义错误如何解决

问题原因 #

你的判断完全正确，多重定义报错的核心原因就是该库将函数、全局变量的定义直接放在了头文件中。

C++项目编译时每个.cpp/.ino文件都是独立的编译单元，头文件会被完整插入到所有引用它的编译单元中。如果头文件里包含非内联、非静态的函数/全局变量定义，每个编译单元都会生成一份对应符号，链接阶段就会报重复定义错误。
你单文件编译时只有一个编译单元，自然不会出现冲突；而多文件场景下，即使你只在Stimulator.cpp中显式引用了该库的头文件，只要Stimulator.h（或其他被GVS_Simulator_V.1.8.ino引用的头文件）间接包含了SAMDTimerInterrupt.h，就会导致两个编译单元都生成重复符号。

解决方案 #

你可以根据自己的需求任选一种方案处理：

• 方案1：避免头文件间接引用该库
  检查所有公共头文件，把#include <SAMDTimerInterrupt.h>的语句全部移到对应的.cpp文件中，确保该库的头文件只在Stimulator.cpp这一个编译单元被引入，相关定时器操作全部封装在Stimulator.cpp内部，不要对外暴露和该库相关的类型、接口。
• 方案2：修改库的头文件适配多文件编译
  打开SAMDTimerInterrupt.h，给TC3_callback、TCC_callback两个全局变量，以及TC3_Handler、TCC0_Handler两个中断函数的定义前加上static修饰，限制符号作用域仅在当前编译单元，不会对外导出重复符号；如果你的编译环境支持C++11及以上版本，也可以将这些定义改为inline属性，链接时会自动合并多份相同的inline符号。
• 方案3：使用库的适配编译逻辑
  这类头文件-only的库通常会内置多文件编译适配逻辑，你可以只在Stimulator.cpp引入头文件前提前定义对应的专属宏，让头文件仅在该编译单元生成实体定义，其他编译单元引入时仅保留声明。

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