C 語言全局變量在函數中無法修改？形參遮蔽導致的經典錯誤

問題現象

在函數外部定義全局變量 x，並在函數 add() 中嘗試修改它，卻發現全局變量值未改變。附圖顯示代碼結構如下：

int x = 10; // 全局變量

void add(int x) { // 形參同名
    x = x + 3;
}

根本原因：形參遮蔽全局變量

函數 add() 的形參同樣命名為 x，根據 C 語言作用域規則，**局部變量（含形參）會遮蔽同名全局變量** 。編譯器在函數內部解析 x 時，優先綁定到形參，而非全局變量。因此對形參的任何修改僅影響函數棧幀內的副本，全局變量保持不變。

解決方案

1. 移除形參，直接操作全局變量
   既然已定義全局變量，函數無需傳遞參數：

void add(void) {
    x = x + 3; // 直接修改全局 x
}

2. 若需保留參數傳遞，改用不同名稱
   避免命名衝突：

void add(int val) {
    x = x + val; // 全局 x 明確可見
}

3. 使用 extern 關鍵字（跨文件時）
   在多文件項目中，需在使用文件聲明 extern int x;。

最佳實踐建議

• 盡量減少全局變量使用，優先採用參數傳遞與返回值。
• 命名規範：全局變量加前綴（如 g_x），局部變量用簡短名，避免衝突。
• 開啟編譯器警告（-Wall -Wshadow），可自動檢測變量遮蔽問題。

理解作用域鏈與名稱查找規則，是寫出正確 C 代碼的基礎。