在多个类中使用命名空间函数链接器错误

Question

我只是在编写一个函数，我想在我的代码中使用它来调试而不抛出异常。我想要一个已定义的变量 DEBUG_MODE，当设置为 true 时会导致函数打印给定消息，而当设置为 false 时不打印任何内容。我希望它可用于导入文件而无需创建类的任何类，即我包含“Debug.h”并且可以调用 Debug::Log(string message)。

我读到了使用命名空间函数的优点，所以我就这样写了它，但也许我不理解命名空间函数的正确用法。当我在一个类中包含带有命名空间函数的头文件时，它工作得很好，当我在两个不同文件的两个类中使用它时，我得到一个链接器错误：

Error   1   error LNK2005: "void __cdecl Debug::Log(char const *)" (?Log@Debug@@YAXPBD0@Z) already defined in Foo.obj...

这是我的命名空间函数的代码：

#pragma once

#include <cstdio>

// IMPORTANT: Set this to true if you want debug logging, false otherwise
#define DEBUG_MODE true

namespace Debug
{
    void Log(const char* message)
    {
        if (DEBUG_MODE)
            printf(message);
    }

    void Log(const char* messageFormat, const char* parameter)
    {
        if (DEBUG_MODE)
            printf(messageFormat, parameter);
    }
}

现在，如果我将函数设为静态，那么一切正常，但我的印象是，在我的情况下，使用命名空间函数可以替代静态函数。如果可能的话，我还希望能够在另一个文件中定义静态函数。

我应该使用什么？静态函数？命名空间函数？如果是后者，那么如何在两个单独的类/文件中使用命名空间函数而不导致上述链接器错误？

Answer 1

您所缺少的只是 inline 关键字，如下所示：

inline void Log(const char* message)

如果没有inline，则会为每个源文件（包括您的头文件）创建函数。

static 会产生类似的结果，但对于这么小的函数，内联似乎更受欢迎。

---

或者，如果您不想让编译器在所有文件中一次又一次地创建代码，您当然需要在一个 .cpp 文件中只实现一次，并且只在头文件中保留声明。

但是，为了让 DEBUG_MODE 影响它，您需要这样做，例如像这样：

#ifndef DEBUG_MODE

// Dummy implementation
inline void Log(...) {}

#else

// Implemented in Log.cpp
void Log(const char* message);
void Log(const char* messageFormat, const char* parameter);

#endif

Answer 2

尝试使它们内联。否则，您可以在单独的源文件中定义它们，然后在头文件中声明它们。

如果您在标头中将其定义为非内联非静态函数并将其包含在程序的多个源文件中，则链接器将在多个目标文件中呈现相同函数的副本。

有3种解决方案：

1. 使它们内联。
2. 将它们设为静态。
3. 在它们自己的源文件中定义它们并且只在 头文件。

将它们设为静态会导致名称不会被导出，因此它们只能在一个目标文件中知道。但是您仍然会有多个函数副本，但在每个使用它们的目标文件中每个副本只有一个。