C / C++ / 系统课时

重复定义错误从哪里产生

重复定义错误从哪里产生

当多个源文件都把同一个具有外部链接的变量或函数“定义”了一遍,编译往往仍能成功,但链接器会在合并目标文件时发现同名符号冲突。本节用最小工程复现 multiple definition,再把定义位置改回正确结构。

学习目标

  • 区分声明、定义以及它们在编译和链接阶段的作用
  • 能从头文件误写定义的场景复现并定位重复符号
  • 会用 extern 和单一源文件定义修复问题

重复定义为什么在链接阶段出现

每个 .c 文件会先独立编译成一个 .o 目标文件。编译器只需要保证当前翻译单元内部成立,因此两个目标文件都可以各自生成名为 counter、add 的外部符号。真正把所有 .o 合并时,链接器才要求同一个外部符号只有一个有效定义。

头文件定义被多个源文件展开后形成重复外部符号

这也是为什么“头文件能通过编译”并不等于“适合放定义”。头文件通常应放声明,让多个源文件安全共享接口;普通全局变量和普通函数实现则应只在一个源文件中定义。

用最小工程复现冲突

下面的 bad.h 同时定义了全局变量和普通函数。因为它被两个源文件包含,这两份定义会分别进入 a.o 与 b.o。

c
/* bad.h */
int counter = 0;

int add(int a, int b)
{
    return a + b;
}
c
/* a.c */
#include "bad.h"

int f(void)
{
    return add(counter, 1);
}
c
/* b.c */
#include "bad.h"

int g(void)
{
    return add(counter, 2);
}
c
/* main.c */
int f(void);
int g(void);

int main(void)
{
    return f() + g();
}

先分别编译,再检查两个目标文件里的已定义符号:

bash
gcc -c a.c b.c main.c
nm -j --defined-only a.o | sort
nm -j --defined-only b.o | sort

预期输出:

text
add
counter
f
add
counter
g

add 与 counter 同时出现在两个目标文件中,已经说明链接时会发生竞争。继续链接:

bash
gcc a.o b.o main.o -o app

预期结果:

text
multiple definition of 'counter'
multiple definition of 'add'
collect2: error: ld returned 1 exit status

不同 GNU 工具链会补充不同的对象文件路径、地址或行号,但核心诊断都是同名外部符号出现了多个定义。

正确修复:声明放头文件,定义只留一份

共享变量在头文件中用 extern 声明,函数只写原型;真正的变量定义和函数实现放到一个 .c 文件中。

c
/* shared.h */
extern int counter;
int add(int a, int b);
c
/* shared.c */
#include "shared.h"

int counter = 0;

int add(int a, int b)
{
    return a + b;
}

其他源文件只包含 shared.h。这样每个翻译单元都知道符号的类型和接口,但最终只有 shared.o 提供外部定义。若把原来的 a.c、b.c 改为包含 shared.h,再加入 shared.c 编译链接,就不会发生重复定义。

static 也能让文件级符号变成内部链接,但它会让每个源文件得到各自独立的一份对象,不适合用来修复“本来就应该共享同一全局状态”的设计。头文件中的小型辅助函数若确实需要内联,可考虑 static inline,这属于另一种有明确语义的写法。

遇到 multiple definition 时怎么查

先看诊断里重复的符号名,再反查哪些目标文件定义了它。GNU nm 的 -A 会把对象文件名一起打印出来:

bash
nm -A --defined-only *.o | grep ' counter$'

预期结果会列出至少两个包含 counter 定义的目标文件,例如:

text
a.o:0000000000000000 B counter
b.o:0000000000000000 B counter

地址宽度可能因目标平台而不同,但如果同一个本应唯一的外部符号出现在多个 .o 中,就应继续回查对应源文件和头文件。最常见根因是把普通全局变量、普通函数实现直接写进公共头文件,或把同一个实现源文件重复加入了构建目标。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

重复定义错误从哪里产生

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通