Windows编译正常的C++代码在Linux下出现多重定义错误求助

这种跨平台编译的坑我可踩过不少，别着急，多重定义错误在Windows的MSVC和Linux的GCC编译器差异里算是很常见的问题，咱们一步步排查：

• 头文件重复包含与定义溢出
  Windows的MSVC编译器对一些非标准写法会比较“宽容”，比如头文件里直接放函数实现或者全局变量定义，它可能通过链接优化自动合并重复符号，但GCC会严格遵循C++标准报错。解决这个的核心是给所有头文件加上头文件保护，同时避免在头文件里放非inline的函数实现、全局变量定义：

  // 示例：heap.h的正确写法
  #ifndef HEAP_H
  #define HEAP_H
  
  // 只放类声明、函数声明，全局变量用extern声明
  class Heap {
  public:
      void insert(int val); // 仅声明
      inline int getSize() const { return _size; } // inline函数可以直接写实现
  private:
      int _size = 0;
  };
  
  extern int global_heap_flag; // 全局变量声明，不要定义
  
  #endif // HEAP_H
  

  然后把函数实现、全局变量定义放到对应的.cpp文件里：

  // heap.cpp
  #include "heap.h"
  
  void Heap::insert(int val) {
      // 具体实现逻辑
  }
  
  int global_heap_flag = 1; // 全局变量在这里定义
  

• Makefile编译规则错误
  检查你的Makefile是不是不小心重复编译了同一个.cpp文件，或者把.h文件也加到了编译列表里（完全没必要）。比如如果你的Makefile里写了类似obj/main.o: main.cpp heap.h heap.cpp这种错误规则，就会导致heap.cpp被多次编译，生成重复的符号。正确的规则应该是每个.cpp对应一个.o文件：

  CC = g++
  CFLAGS = -Wall -g
  
  all: heap_program
  
  heap_program: main.o heap.o
      $(CC) $(CFLAGS) -o $@ $^
  
  main.o: main.cpp heap.h
      $(CC) $(CFLAGS) -c $<
  
  heap.o: heap.cpp heap.h
      $(CC) $(CFLAGS) -c $<
  
  clean:
      rm -f *.o heap_program
  

• inline函数的差异处理
  如果你的头文件里有非inline的成员函数实现（比如直接写在类定义里的非inline函数），MSVC可能会默认把它当成inline处理，但GCC不会。这种情况要么给函数加上inline关键字，要么把实现移到.cpp文件里。

先从这几个方向排查，大概率能解决问题——毕竟Windows到Linux的编译差异，很多时候都是标准合规性的问题~

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