Delphi 原始碼格式撰寫規範（一）第 2 節：變數命名、區域/全域變數與類型大小寫協定

本文為 Delphi 程式碼規範系列第一部分的第 2 節，涵蓋變數命名規則、區域變數、全域變數管理、類型大小寫協定與浮點數類型選擇建議。

3.3 變數命名與格式

3.3.1 通用命名原則

• 有意義名稱：使用完整英文單詞，單詞首字母大寫 (PascalCase)，如 WriteFormat: string
• 特定類型簡寫 (可選，團隊統一)：
  • 指標：P 前綴 (如 PUserRecord)
  • 記錄：Rec 後綴/中綴
  • 陣列：Arr 後綴/中綴
  • 類別：Class 後綴/中綴
• 迴圈控制變數：單字母 i, j, k 或有意義名稱 UserIndex

3.3.2 區域變數

遵循通用命名規則，於 var 區塊宣告，盡量貼近使用位置 (Delphi 傳統要求在區塊開頭)。

3.3.3 全域變數管理 (核心規範)

跨模組資料共享正確模式：屬性封裝

type
  TFormOverdraftReturn = class(TForm)
  private
    FUserName: string;
    FUserCount: Integer;
    procedure SetUserName(Value: string);
    function GetUserName: string;
  public
    property UserName: string read GetUserName write SetUserName;
    property UserCount: Integer read FUserCount write FUserCount;
  end;

優勢：存取控制、驗證邏輯集中、支援介面導向設計、利於單元測試。

3.4 類型大小寫協定

var
  MyString: string;        // 保留字
  WindowHandle: HWND;      // Win32 API
  I: Integer;              // 系統單元型別識別碼

3.4.2 浮點數類型選擇建議

最佳實踐摘要

1. 變數名 PascalCase，見名知意
2. 嚴禁濫用全域變數，跨單元通訊走屬性/介面
3. 類型大小寫區分 來源層級 (保留字/API/自訂)
4. 一般計算用 Double，金融用 Currency，極限精度才用 Extended

這些規範看似瑣碎，但能消除團隊協作中 80% 以上的「風格衝突」與「隱性 Bug」，是專業 Delphi 團隊的基礎建設。