Mac下g++编译出现duplicate symbol错误的原因与解决

错误类型确认 #

这是链接错误，错误信息来自链接器ld——链接阶段负责将多个目标文件合并为可执行文件，当发现同一个符号被多次定义时，就会抛出此类错误。

错误详情解析 #

报错中的符号是C++名字修饰后的结果，还原后对应两个ostream的vector输出运算符重载：

• __ZlsRSoRKSt6vectorIiSaIiEE → std::ostream& operator<<(std::ostream&, const std::vector<int>&)
• __ZlsRSoRKSt6vectorIbSaIbEE → std::ostream& operator<<(std::ostream&, const std::vector<bool>&)

这两个函数同时在临时编译文件（ccvDBwwZ.o，由main.cpp/grammar.tab.cpp/lex.yy.c其中之一生成）和t1.o中被定义，导致链接冲突。

问题原因分析 #

1. 头文件直接定义函数：如果t1.h中直接编写了operator<<的函数体（而非仅声明），且多个.cpp文件（比如main.cpp、grammar.tab.cpp）都包含了t1.h，那么每个编译生成的目标文件都会包含该函数的定义，链接时就会重复。
2. 重复实现函数：t1.cpp中定义了这些operator<<重载，同时其他.cpp文件（比如main.cpp或扫描器/语法分析器生成的代码）中也存在完全相同的重载实现。
3. 旧目标文件残留：多次更新代码后，旧的t1.o或临时编译文件未被清理，新旧代码的符号定义发生冲突。

解决步骤 #

1. 定位重复符号的来源 #

使用nm命令查看目标文件中的符号状态：

• 检查t1.o中的符号：

  nm t1.o | grep __ZlsRSoRKSt6vectorIiSaIiEE
  

  若输出以T开头，说明t1.o中包含该函数的定义。
• 分别编译其他源文件为目标文件并检查：

  g++ -c -std=c++11 main.cpp -o main.o
  nm main.o | grep __ZlsRSoRKSt6vectorIiSaIiEE
  

  重复上述命令检查grammar.tab.cpp和lex.yy.c生成的目标文件，找到另一个包含该符号定义的文件。

2. 修复重复定义 #

• 头文件定义问题：
  • 将t1.h中operator<<的函数体移到t1.cpp中，头文件仅保留声明：

    // t1.h（仅声明）
    #include <ostream>
    #include <vector>
    std::ostream& operator<<(std::ostream&, const std::vector<int>&);
    std::ostream& operator<<(std::ostream&, const std::vector<bool>&);
    

    // t1.cpp（实现）
    #include "t1.h"
    std::ostream& operator<<(std::ostream& os, const std::vector<int>& vec) {
        // 自定义实现代码
        return os;
    }
    std::ostream& operator<<(std::ostream& os, const std::vector<bool>& vec) {
        // 自定义实现代码
        return os;
    }
    

  • 或者在头文件的函数定义前添加inline关键字，确保多个编译单元包含时不会产生重复定义：

    // t1.h
    #include <ostream>
    #include <vector>
    inline std::ostream& operator<<(std::ostream& os, const std::vector<int>& vec) {
        // 自定义实现代码
        return os;
    }
    

• 重复实现问题：删除其他文件中重复的operator<<定义，仅保留t1.cpp中的实现。

3. 优化Makefile编译规则 #

将当前直接编译多个源文件的规则，改为分步编译生成单独目标文件，便于后续排查问题：

INITFILE_Scanner = scanner.l
INITFILE_Grammar = grammar.ypp

compiler: main.o grammar.tab.o lex.yy.o t1.o
        @g++ -std=c++11 main.o grammar.tab.o lex.yy.o t1.o -o prog

main.o: main.cpp lib/parse_tree.h
        @g++ -c -std=c++11 main.cpp -o main.o

grammar.tab.o: grammar.tab.cpp
        @g++ -c -std=c++11 grammar.tab.cpp -o grammar.tab.o

lex.yy.o: lex.yy.c
        @g++ -c -std=c++11 lex.yy.c -o lex.yy.o

t1.o: t1.h t1.cpp
        @g++ -c -std=c++11 t1.cpp -o t1.o
        
lex.yy.c: $(INITFILE_Scanner)
            @lex -w $(INITFILE_Scanner)

grammar.tab.cpp: $(INITFILE_Grammar)
            @bison -d $(INITFILE_Grammar)

clean:
        rm -f prog *.o lex.yy.c grammar.tab.cpp grammar.tab.h

4. 清理旧文件并重新编译 #

执行清理命令删除旧的目标文件和临时文件：

make clean

然后重新编译：

make

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