【C/C++】在头文件中定义全局变量的方法

在 C++ 中，不建议将全局变量的定义直接放在头文件中，除非使用特定的现代 C++ 特性。

直接在头文件中定义全局变量（例如 int g_count = 0;）会违反 C++ 的"单一定义规则"（One Definition Rule, ODR）。当一个头文件被多个源文件（.cpp）包含时，该变量的定义会被复制到每个源文件中，导致链接器在链接阶段报错，提示"multiple definition"（重复定义）。

不过，有几种安全且标准的方法可以实现跨文件共享全局变量。

✅ 推荐方案

方案一：传统方法 (extern 声明)

这是最经典、兼容性最好的方法，适用于所有 C++ 标准。

1. 在头文件中声明 ：使用 extern 关键字声明变量，告诉编译器这个变量在其他地方定义。
2. 在源文件中定义 ：在且仅在一个 .cpp 文件中定义并初始化该变量。

示例代码：

// globals.h
#ifndef GLOBALS_H
#define GLOBALS_H

extern int g_count; // 声明，不分配内存
extern double g_pi;

#endif // GLOBALS_H

// globals.cpp
#include "globals.h"

int g_count = 0;   // 定义并初始化，只出现一次
double g_pi = 3.14159;

现在，任何其他 .cpp 文件只需 #include "globals.h" 即可使用 g_count 和 g_pi。

方案二：现代方法 (inline 变量，C++17 起)

从 C++17 开始，inline 关键字可以用于变量。这允许你在头文件中直接定义变量，而不会导致重复定义错误。链接器会保证整个程序中只有一个该变量的实例。

示例代码：

// globals.h
#ifndef GLOBALS_H
#define GLOBALS_H

inline int g_count = 0;      // 直接定义，C++17 特性
inline double g_pi = 3.14159;

#endif // GLOBALS_H

这种方式非常简洁，无需额外的 .cpp 文件，特别适合用于纯头文件库（header-only libraries）。

方案三：最佳实践 (Meyers' Singleton)

对于复杂的对象（如 std::vector、配置类等），为了避免静态初始化顺序问题，推荐使用函数内的局部静态变量，这被称为 Meyers' Singleton 模式。

示例代码：

// globals.h
#ifndef GLOBALS_H
#define GLOBALS_H

#include <vector>

// 声明一个访问函数
std::vector<int>& getGlobalData();

#endif // GLOBALS_H

// globals.cpp
#include "globals.h"

std::vector<int>& getGlobalData() {
    static std::vector<int> data; // 首次调用时初始化，线程安全 (C++11起)
    return data;
}

使用时，通过调用 getGlobalData() 函数来获取全局对象的引用。这种方式实现了延迟初始化，完全避免了初始化顺序的烦恼。

❌ 错误示范

以下是在头文件中定义全局变量的错误方式，会导致链接错误。

// globals.h (错误！)
#ifndef GLOBALS_H
#define GLOBALS_H

int g_count = 0; // 错误：定义在头文件中

#endif // GLOBALS_H

⚠️ 特殊说明：const 全局常量

const 全局变量在 C++ 中默认具有内部链接（internal linkage），这意味着它们只在定义它们的源文件内可见。

• 如果只想在单个文件内使用 ：可以直接在头文件或源文件中定义 const 变量。
• 如果想跨文件共享 ：需要遵循 extern 的声明/定义规则。

// constants.h
#ifndef CONSTANTS_H
#define CONSTANTS_H

extern const int MAX_SIZE; // 声明

#endif // CONSTANTS_H

// constants.cpp
#include "constants.h"

const int MAX_SIZE = 1024; // 定义

总结对比

方案	适用标准	优点	缺点
extern 声明	所有 C++ 标准	兼容性好，定义位置明确	代码分散，需要维护两个文件
inline 变量	C++17 及以上	代码简洁，声明定义合一	需要较新的编译器支持
Meyers' Singleton	C++11 及以上	线程安全的延迟初始化，避免初始化顺序问题	访问方式稍复杂，需要通过函数调用

建议：

• 如果项目可以使用 C++17 或更高版本，优先使用 inline 变量，最简单直接。
• 如果项目模块多，担心初始化顺序问题，强烈推荐 Meyers' Singleton。
• 如果需要兼容老版本编译器，则使用传统的 extern 方式。