程式設計風格規範系列（一）：程式風格基石 — 縮排、資源字串、變數定義位置

前言

本系列開幕篇確立 **程式風格三大基石**：階梯縮排、資源化字串、變數定義前置，為後續命名、註解、健壯性、模組化等規範提供可視化、可維護的代碼骨架。

一、嚴格階梯縮排：VC 預設風格 (4 空格、大括號換行、對齊)

void main()
{
    // 變數定義區
    long lI;       // 迴圈索引
    long lSum;     // 累加和
    float fAvg;    // 平均值

    // 累加 0~9
    for (lI = 0; lI < 10; lI++)
    {
        lSum = lSum + lI;
        // 多行語句再縮排 4 格
        if (lI % 2 == 0)
        {
            // 偶數特殊處理
        }
    }

    // 計算平均
    fAvg = lSum / 10.0f;
}

鐵律

1. **縮排單位 = 4 空格** (非 Tab，避免跨編輯器顯示錯亂)。
2. **左大括號 `{` 獨佔一行**，與對應關鍵字 (`if`/`for`/`while`/函數頭) 對齊。
3. **右大括號 `}` 獨佔一行**，與左大括號同欄對齊。
4. **續行再縮排 4 格**，參數對齊或邏輯分組對齊。
5. **空行分隔邏輯區塊** (變數定義、迴圈、計算、返回)。

二、提示字串資源化：支援多語言、分離程式與內容

• **除暫時除錯訊息外，所有面向使用者的字串 (錯誤、提示、選單、工具提示) 必須放入資源檔 (.rc / .resx / .po)**。
• 代碼中僅引用資源 ID：`LoadString(IDS_ERR_OPEN_FILE)`。
• 效益：
  ▸ 多語言版本零代碼修改，僅替換資源 DLL/檔案。
  ▸ 文案人員可獨立編輯，無需重新編譯。
  ▸ 字串集中管理，避免重複/拼寫不一致。

三、變數定義前置：函數開頭集中宣告

• **所有區域變數在函數開頭連續定義**，混雜在代碼中間的定義 **嚴禁**。
• 配合「單一出口」風格，變數生命週期清晰可見，除錯時監視視窗一次捕獲全部區域狀態。
• C99/C++ 允許混合宣告，但本規範為 **可讀性與審查效率** 強制前置。

總結

風格規範不是為了「好看」，而是為了 **降低認知負荷、統一團隊視覺語言、讓缺陷無處遁形**。4 空格階梯縮排讓控制流一目了然；資源化字串讓國際化從架構層面解決；變數前置讓函數上下文零驚喜。三大基石落地，後續命名、註解、錯誤處理、模組化才能在乾淨畫布上施展。