Qt/C++全局作用域运算符重载出现多重定义编译错误如何解决？

这是C++**单定义规则（ODR）**导致的链接阶段错误，和运算符重载本身的语法无关。
你将operator-(int, Real)的完整实现直接写在了头文件qtrigonometry.h中，而这个头文件同时被qtrigonometry.cpp、sandbox.cpp两个源文件引入。头文件的#include本质是预编译阶段将头文件的内容全量插入到源文件的对应位置，所以两个源文件编译生成的.o目标文件中，都会各自保留一份operator-(int, Real)的实现代码。链接器合并符号时发现同一个全局函数存在多个相同定义，不符合单定义规则，就会抛出多重定义报错。
Clang只做单编译单元的语法检测，不会检查跨编译单元的符号冲突，所以编译阶段不会报错，只有链接阶段才会触发问题。

你可以任选以下任意一种方式修复：

• 将函数实现移动到源文件中：头文件仅保留函数声明double operator-( int n, const Real m );，把具体的实现逻辑放到qtrigonometry.cpp里，这样全局只会生成一份函数定义
• 给头文件中的函数添加inline修饰：修改为inline double operator-( int n, const Real m ) { return n - m.m; }，inline关键字会告知链接器允许多个相同的函数定义，合并时自动保留一份即可，适合逻辑简单的小函数直接放在头文件中
• 给头文件中的函数添加static修饰：这样每个引入头文件的编译单元都会生成一份独立的静态函数副本，互相不会产生符号冲突，缺点是会略微增加最终生成的程序体积

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