匯編語言的藝術：準備工作——統一格式與註解規範（五）

第四節 統一格式：團隊協作的基石

一、格式統一的優勢

無論何種語言，團隊協作、代碼傳承、品質保證都要求統一的編碼風格。良好的程式如優美散文，兼具技巧與意境，不僅執行高效，更便於同行研習鑑賞。組合語言更是如此：無統一格式，代碼無異天書；有了規範，養成習慣後，閱讀、修改、撰寫皆輕鬆順手。

二、編碼規格細則

1. 全大寫：指令、暫存器、標號皆大寫，提升可讀性。
2. Tab 對齊：縮進使用 Tab 鍵，齊頭等距，結構一目瞭然。
3. 標題獨行：標號後立即換行，避免擁擠。
4. 行長限制：每行不超過 70 字元，防止畫面錯亂。
5. 註解定位：註解置於第 5 個 Tab 起點，空間不足換行但對齊位置。
6. 緩衝區前置：所有緩衡區定義集中在程式開頭，不得散落於代碼中。
7. 避免無意義 PROC：除跨段 FAR CALL 需 PROC FAR 外，禁用 PROC NEAR。
8. 程式首註：開頭必須有說明用途、參數、注意事項的註解區塊。

三、範本實例

PAGE 60,132
TITLE [程式名],[作者代號],[編號],[功能說明]

DG SEGMENT PUBLIC
extrn bwsca1:word,..
DG ENDS
..
CG SEGMENT PUBLIC
extrn mmmm:near,..
public xxxx,yyyy,..
ASSUME CS:CG,DS:DG,ES:DG
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; REM ...... ;
; ............ ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
START:
CLD
MOV AX,DG
MOV DS,AX
..
CG ENDS
END START

PAGE 設定列印版面；TITLE 供查閱識別；REM 區塊詳細記錄功能、調用條件，利於團隊共用。

四、註解的藝術：為未來的自己與他人著想

註解核心在於「可維護性」。重點涵蓋六大面向：

1. 功能：做什麼，前置條件何在。
2. 參數：輸入資料格式與暫存器約定。
3. 緩衝區：使用哪些緩衝區，特性為何。
4. 結果：執行後的輸出與狀態變化。
5. 子程式調用：本段依賴的外部子程式名稱。
6. 重要聲明：暫存器是否被破壞、特殊副作用等。

範例：

【功能】：讀鍵盤緩衝區輸入碼，依性質返回 ASCII+掃描碼或中文內碼
【參數】：AH = 00H
【返回】：若 AL<80H，AH=掃描碼，AL=ASCII；若 AL≥80H，AL=中文內碼之一
【破壞暫存器】：AX
【備註】：取中文內碼須連續調用 4 次，依序得到 4 字元內碼

建議流程：初期專注邏輯實現，註解可略；功能完成、除錯無誤後，再全程精讀重構，補齊註解、優化代碼、合併重複、刪除冗餘。此過程不僅產出優質文檔，更是程式設計師技術昇華的關鍵契機。