用得恰當的注釋,能在開發過程中替自己和同事省下大量時間。最常見的用途是替規則補上說明,但它其實還能承擔組織與導航的功能。
這是最基本的用法:留下說明,避免後人(或後的自己)猜測。關鍵是簡潔。
/* 移除圖片連結的預設邊框 */
img { border: 0; }
許多人在樣式表頂端標記最後修改時間與作者,等於附上了文件狀態與聯絡資訊。
/* Styles Updated: Thu 4.11.08 @ 17:15 p.m. Author: WEBJX.com —— */
團隊協作時這招特別有用。不過要注意,有些組織要求把這類資訊寫在檔案內,有些公司則偏好放在版本控制系統裡;動手之前先確認團隊慣例,別讓樣式表變成履歷牆。
用注釋標出區塊邊界,是讓長檔案保持可讀的關鍵。當所有 header 相關規則集中在一段時,一條分隔線就能把它和後續內容切開。
/* HEADER ————————————————— */
如果檔案已依區塊劃分,可以再加上一層「錨點」設計,讓編輯器的搜尋功能成為快速跳轉的入口。
/* =HEADER ————————————————— */
做法是在章節名稱前加上等號(=)這類不常出現在一般程式碼中的字元,然後用「搜尋 =」就能在章節之間逐個跳。這在動輒上千行的樣式表中特別有感——不必滾動條拉到底,也不必依賴折疊功能,幾個鍵盤敲擊就能抵達目標段落。
這幾個技巧成本都很低,但只有在持續使用的前提下才會產生複利。