全局变量定义只能在单一源文件中进行并初始化,声明则需用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,带初始化就等价于定义,跨文件重复就会冲突。
常见错误写法:
立即学习“C++免费学习笔记(深入)”;
// 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; 就会导致未定义行为。










