多重定义符号的链接器错误

Question

我的文件结构如下：

X.h

#pragma once

#include "Y.h"

int ONE = 1;

int combine();

X.c

#include "X.h"

int combine()
{
    return ONE + TWO;
}

Y.h

#pragma once

int TWO = 2;

Y.c

#include "Y.h"

Main.c

#include "X.h"

int main()
{
    int fusion = combine();

    return 0;
}

我收到以下错误：

LNK1169 one or more multiply defined symbols found

LNK2005 _ONE already defined in Main.obj

LNK2005 _TWO already defined in Main.obj

KLNK2005 _TWO already defined in Main.obj

这是零意义。如果我们从Main.c 开始，编译器必须包含X.h。然后编译器查找与X.h 关联的C 文件。在X.c 中，它需要包含X.h，但#pragma once 应该提防这种情况。然后它需要包含Y.h。它查找 C 文件并找到 Y.c，它说包含 Y.h，但 Y.h 已经包含在内。然后，它返回到 Main.c 并且应该成功编译......但是没有。

我可以将/FORCE 添加到我的项目设置中，这使我的代码可以完美运行，但仍会输出：

ONE has already been defined, second definition ignored.

Answer 1

但#pragma once 应该提防这种情况

#pragma once 用于避免重复包含在单个翻译单元（本例中为.c 文件）中，但它不能防止多个定义跨越多个翻译单元。

您在.h文件中定义了全局变量ONE和TWO，它们被包含在多个翻译单元中并导致多个定义错误。

例如，最后，ONE 将在X.c 和Main.c 中定义，TWO 将在Y.c、X.c 和Main.c 中定义。

您应该在.h 文件中声明ONE 和TWO（使用extern），并在.c 文件中定义它们。

X.h

#pragma once

#include "Y.h"

extern int ONE;
int combine();

X.c

#include "X.h"

int ONE = 1;

int combine()
{
    return ONE + TWO;
}

Y.h

#pragma once

extern int TWO;

Y.c

#include "Y.h"

int TWO = 2;

Answer 2

#pragma once 只防止同一个头文件在同一个编译单元中包含两次。当您在多个编译单元中定义相同的变量时，它不会防止出现问题。

要看看有什么问题，让我们来看看每个编译单元在编译时的样子。

经过预处理后，X.c 最终看起来像这样：

int TWO = 2;

int ONE = 1;

int combine();

int combine()
{
    return ONE + TWO;
}

如您所见，它包含符号TWO、ONE 和combine 的定义。

Y.c 最终看起来像这样：

int TWO = 2;

它还定义了符号TWO。

main.c 看起来像这样：

int TWO = 2;

int ONE = 1;

int combine();

int main()
{
    int fusion = combine();

    return 0;
}

所以它还定义了TWO 和ONE，以及main。

所以编译后，我们最终得到了 3 个目标文件，这三个目标文件都有TWO 的定义，其中两个有ONE 的定义。当我们开始链接时，链接器会在combine 的定义中看到对ONE 和TWO 的引用，然后去寻找这些符号的定义。由于它们是在多个位置定义的，因此会引发错误并放弃。

您可以通过在 X.h 和 Y.h 中声明 ONE 和 TWO 以及在 X.c 和 Y.c 中定义 ONE 和 TWO 来解决此问题。 p>

Answer 3

#pragma once 防止在编译单个源模块时多次包含头文件。

就是这样。

您的头文件被包含在两个不同的源模块中。

该头文件在全局范围内声明并定义了一个对象。

因此，您的两个源模块最终都会在全局范围内定义相同的对象。

这就是重复符号定义的来源。

#pragma once 不能替代了解和理解 C++ 范围规则。