C語言防止重定義完全指南：頭文件衛士與定義分離

重定義錯誤的兩大來源

C 程序編譯報 redefinition 錯誤，主要來自兩個階段：

1. 編譯階段：類型定義（struct、typedef、enum 等）被重複包含展開
2. 鏈接階段：全局變量、函數實體定義在多個編譯單元中出現

對策一：頭文件衛士——防止編譯階段類型重定義

標準模板：

#ifndef _HEADER_NAME_H
#define _HEADER_NAME_H

/* 類型定義、宏、函數聲明、extern 變量聲明 */

#endif

機制：首次包含時宏未定義，進入內部並定義宏；再次包含時宏已定義，#ifndef 失效，內容被跳過。

命名規範：宏名通常用 _FILENAME_H 格式，大寫並加下劃線前綴，避免衝突。

對策二：頭文件只放聲明，定義放在 .c 文件——防止鏈接階段實體重定義

錯誤示範：在 head.h 中定義 char str1[] = "char1";，多個 .c 包含該頭文件，鏈接時出現多重定義。

正確做法：

/* head.h */
#ifndef _HEAD_H
#define _HEAD_H
extern char str1[];  // 聲明
extern char str2[];
#endif

/* head.c */
#include "head.h"
char str1[] = "char1";  // 定義
char str2[] = "char2";

/* test1.c */
#include "head.h"
void test1() { printf("%s", str1); }

/* test2.c */
#include "head.h"
void test2() { printf("%s", str2); }

對策三：static 限制作用域——文件內部私有實體

若某全局變量/函數僅在當前 .c 文件使用，加 static 使其具有內部鏈接屬性，不參與鏈接，從根源避免衝突：

static int private_counter = 0;
static void helper_func(void) { ... }

總結：三層防線

大多數程序員只知道第一層，掌握三層才能徹底解決重定義問題，構建清晰的模塊邊界。