C++ 全局变量定义与 extern 使用方法

全局变量定义只能在单一源文件中进行并初始化，声明则需用extern且不带初始化值；头文件中应仅含extern声明并配合include guard，static全局变量则限于本文件作用域。

全局变量定义和声明要分开写

在 C++ 里，int g_value = 42; 这样的语句如果写在多个源文件（比如 a.cpp 和 b.cpp）里，链接时会报 multiple definition of 'g_value' 错误。根本原因是：**定义产生符号并分配内存，只能有一次；声明只是告诉编译器“这东西存在”，不分配内存。**

所以必须严格区分：

• 在一个且仅一个 .cpp 文件中做 定义：int g_value = 42;
• 在其他需要使用的 .cpp 文件（或头文件）中做 声明：extern int g_value;

extern 声明不能带初始化值

extern 的作用是“声明外部定义”，它本身不分配存储空间。一旦你写成 extern int g_value = 100;，编译器就把它当作定义了——即使加了 extern，带初始化就等价于定义，跨文件重复就会冲突。

常见错误写法：

// bad.h
extern int g_counter = 0; // ❌ 错误！这是定义，不是声明

正确做法是把初始化只留在一个 .cpp 里：

// global.cpp
int g_counter = 0; // ✅ 定义 + 初始化

// utils.cpp
extern int g_counter; // ✅ 声明，无初始化
void inc() { ++g_counter; }

头文件里放 extern 声明要防重复包含

如果把 extern int g_config_flag; 直接写在头文件 config.h 里，又在多个 .cpp 中 #include "config.h"，虽然 extern 本身允许多次声明，但更稳妥的做法是配合 include guard 或 #pragma once，避免意外宏展开干扰。

另外注意：不要在头文件里写定义（哪怕没加 extern），例如：

// config.h —— 千万别这么写！
int g_version = 1; // ❌ 每个包含它的 .cpp 都会产生一个定义

应该写成：

// config.h
#pragma once
extern int g_version; // 声明

// version.cpp
#include "config.h"
int g_version = 1; // 定义

static 全局变量和 extern 的区别别搞混

static int g_local = 5; 在文件作用域下，表示该变量只在当前 .cpp 内可见，链接器看不到它——它和 extern 是反向操作：extern 是“我要用别的文件的”，static 是“我谁也不给”。

如果你看到别人在头文件里写了 static int g_buf[1024];，那每个包含它的 .cpp 都会得到一份独立副本，这不是共享全局变量，而是“伪全局”——容易误以为是同一个变量，实际是多个同名但隔离的变量。

真正跨文件共享，只有一条路：一个定义 + 多个 extern 声明。

最容易被忽略的是：extern 声明的类型必须和定义完全一致（包括 const、引用、volatile 等修饰符），否则链接可能成功但运行出错，比如 extern const int x; 对应的定义是 int x = 1; 就会导致未定义行为。