Delphi 初學者必避六大坑：類別結構、事件順序、字串型別、轉換陷阱、單元循環引用

坑 1：誤解單元結構與 Self 指標

var Form1: TForm1; 位於 implementation 區，屬全域變數，非類別成員。表單方法中必須用 Self.Caption 或直接 Caption，寫 Form1.Caption 雖能編譯但屬硬編碼全域實例，違背物件導向原則，多實例時必出錯。

坑 2：在 OnClose 釋放物件導致 Access Violation

OnClose 僅隱藏視窗，資源未釋放；OnDestroy 才真正銷毀。釋放代碼必須寫在 OnDestroy，否則後續存取已釋放記憶體觸發 AV。

坑 3：不分 String 與 ShortString

• String（預設 AnsiString）：動態配置、參考計數、長度 2GB、以 #0 結尾。
• ShortString：固定 255 字元、棧上分配、長度位元組前綴。

短字串場景（如代碼、標識）優先用 ShortString 或 string[20]，減少堆疊管理開銷，提升效能。

坑 4：字串轉數值未防異常輸入

I := StrToInt(Edit.Text) 若使用者輸入非數字將拋出 EConvertError。正確寫法：

I := StrToIntDef(Edit.Text, 0); // 失敗回傳預設值 0
// 同理：StrToInt64Def, StrToFloatDef, StrToCurrDef

坑 5：忘記 uses 引用單元

呼叫 API（如 ExtractIconEx）必須 uses ShellApi。編譯失敗時第一時間查閱函數所屬單元並加入 uses，養成查閱幫助文件「單元」欄位習慣。

坑 6：單元循環引用處理不當

• A 引用 B，B 又引用 A → 編譯錯誤。
• 解法：將至少一方引用移至 implementation 區（僅在實作部分需要型別定義時）。
• 原則：interface 區僅引用「介面定義必須」的單元；具體實作依賴移至 implementation。

總結

這六大坑涵蓋語言基礎、記憶體模型、異常安全、編譯系統核心機制。新手若能建立正確心智模型，將大幅減少除錯時間，寫出更健壯、可維護的 Delphi 程式碼。