這是一個代價換來的小教訓,值得記下來。
某天需要替既有頁面擴充樣式,於是在 CSS 檔頭補了一段修改說明,順手把 @charset 規則挪回檔案最上方。改完上傳,頁面出現一部分樣式完全不生效的怪現象。
原本的樣式表開頭是:
@charset "utf-8";
我在搬動過程中不小心漏掉了結尾的分號:
@charset "utf-8"
結果就是這個單獨的分號,讓部分樣式集失效。當時百思不得其解,只好把備份的樣式表回 uploaded 回去,一切恢復正常。後來才聯想到那個被刪掉的分號,補回去重新上傳,果然一切 OK。
CSS 的 @ 規則(at-rule)必須以分號或區塊結束。@charset 是語法層級最前面的規則,它必須是樣式表的第一個字元,前面連空白或註解都不能有。當分號缺失時,解析器會繼續往後吞字元,直到找到合法的分號為止——而下一個分號,往往落在第一條真正的 CSS 規則裡。於是解析器把 @charset "utf-8" 後面那一整段內容都當成了 at-rule 的參數意圖去解析,第一條規則就這樣被吃掉了。
更麻煩的是這種錯誤不一定報錯。瀏覽器的 CSS 錯誤處理是「跳過無效部分並繼續」,所以你不會看到任何提示,只會看到某幾條樣式莫名其妙沒作用。
@charset。它幾乎永遠應該待在檔案第一行,沒理由改位置。<meta charset="utf-8">。實務上這一行已足夠,CSS 檔的 @charset 多半可以省略。declaration-block-trailing-semicolon 規則,這類錯誤在 commit 前就會被攔下。結論很樸素:分號、括號、引號這類語法符號的缺失,是 CSS 最難 debug 的錯誤類型之一,因為它靜默失敗。與其靠細心,不如靠工具——把 lint 掛進流程,比事後憑直覺找問題划算太多。