Swift 支援單行與多行註釋。良好的註釋規範能提升程式可讀性與維護效率。
檔案開頭可寫入版權、檔名、作者、歷史修訂與用途,讓其他人快速了解檔案背景。
使用 /// 或 /** */ 可產生 API 文件,適合說明_protocol、類別、屬性與方法用途。
在關鍵邏輯處使用 // 或 /* */,行尾註釋應簡短並與程式碼保持距離。
MARK、TODO、FIXME 可顯示在 Xcode Jump Bar,方便快速定位方法、待辦事項與修正重點。