在 CSS 中加入適當的註釋,不只是為了說明語法,也能提升團隊協作效率。良好的註釋習慣可讓樣式表更易讀、更易維護。
最常見的用法是說明某段樣式的用途,例如:
/* Turn off borders for linked images */
img { border: 0; }
在檔案或區塊開頭標註更新時間與作者,有助於追蹤變更。但不同團隊規範不同,有些偏好把資訊寫在版本控制系統中,而不是 CSS 檔內。
大型樣式表可依功能分段,例如 HEADER、NAV、CONTENT、FOOTER,讓搜尋與定位更快速。
/* =HEADER -------------------------------*/
使用等號或符號建立章節標記,可搭配編輯器的搜尋功能快速跳轉。這種方式在內容繁多的樣式表中特別有用。
總之,CSS 註釋的價值在於降低理解成本。簡潔、一致且有目的的註釋,會讓後續維護更輕鬆。