C/C++ 專案拆分多個 .cpp 文件時，如何在多文件間共享全局變量是基礎且關鍵的問題。錯誤做法會導致重複定義鏈接錯誤、隱式聲明警告或運行時不可預期行為。本文將通過標準模式、存儲類別、鏈接屬性三個維度，給出工業級最佳實踐。
定義：分配存儲空間，可初始化。
聲明：告知編譯器類型與名稱，不分配空間，使用extern關鍵字。
common.h#ifndef COMMON_H
#define COMMON_H
// 僅聲明，不定義
extern int g_config_version; // 可讀寫全局變量
extern const char* g_app_name; // 僅讀指針
extern const int MAX_CONNECTIONS; // 常量（需 C++17 inline 或單獨定義）
// 函數聲明
void init_globals(void);
#endif
globals.cpp（且僅此文件定義）#include "common.h"
int g_config_version = 1; // 定義並初始化
const char* g_app_name = "MyApp"; // 定義
const int MAX_CONNECTIONS = 100; // 定義 (C++17 前需此處定義)
void init_globals(void) {
g_config_version = 2;
}
module_a.cpp / module_b.cpp#include "common.h"
void module_a_func() {
printf("Version: %d\n", g_config_version); // 直接使用
g_config_version++;
}
// module_internal.cpp
namespace { // C++ 匿名命名空間，等價於 C 的 static
int internal_counter = 0; // 僅本翻譯單元可見，無符號導出
}
static float module_factor = 1.0f; // C 風格，同樣內部鏈接
inline)// constants.h
#pragma once
inline constexpr int MAX_BUFFER = 4096; // 編譯期常量，單一實體
inline const std::string DEFAULT_CONFIG = "config.json"; // 運行期常量，單一實體
無需 .cpp 定義，多文件包含不重複定義，外部鏈接。
inline 變量)// state.h
#pragma once
inline int g_runtime_counter = 0; // 所有包含文件共享同一實體
慎用：全局可變狀態增加耦合，優先考慮單例類、依賴注入、模塊級靜態成員。
// common.h (C)
#ifndef COMMON_H
#define COMMON_H
extern int g_count; // 聲明
extern const int LIMIT; // 常量聲明
#endif
// globals.c
#include "common.h"
int g_count = 0;
const int LIMIT = 100; // C 中 const 默認外部鏈接，需此處定義
| 錯誤現象 | 原因 | 修正 |
|---|---|---|
| 鏈接錯誤：multiple definition of `g_var' | 頭文件直接定義 int g_var = 0;，多 .cpp 包含導致多重定義 | 頭文件用 extern，.cpp 定義 |
| 編譯錯誤：`g_var' undeclared | 使用文件未包含聲明頭文件 | #include "common.h" |
| 運行時值不一致 | 多文件各自定義 static int g_var，產生多份副本 | 去掉 static，改用 extern + 單一定義 |
| 常量在頭文件定義報錯 (C++17 前) | const int MAX = 100; 默認外部鏈接，多重定義 | 加 static 或 inline (C++17) 或移至 .cpp 定義 |
extern) 才能生成正確引用。globals.h/globals.cpp 對，集中管理跨模塊全局狀態。extern)，嚴禁定義 (除 inline/constexpr/模板)。inline constexpr (C++17) 放頭文件。-Wall -Wextra -Werror，捕獲隱式聲明、重複定義等問題。「一處定義，多處聲明」是 C/C++ 多文件協作的基石。理解聲明 vs 定義、外部 vs 內部鏈接、ODR 原則，配合現代 C++ inline/匿名命名空間，能讓項目結構清晰、符號可控、鏈接零驚喜。
