萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

CSS 代碼書寫風格規範:縮進、換行、分號與可讀性工程化標準

推薦風格:展開式多行寫法

.classname {
  width: 100px;
}

核心規範細則

  1. 選擇器分行:聯合選擇器每個選擇器獨佔一行,便於搜尋、Diff、合併。
    .btn,
    .btn--primary,
    .btn--secondary { ... }
  2. 大括號間距:最後一個選擇器與 { 之間一空格,} 獨佔行頂格對齊選擇器。
    .classname {
    }
  3. 聲明獨行:每行一條聲明,屬性值後緊跟分號,無空格。
    property: value;
  4. 尾隨分號強制:最後一條聲明也加分號,防止新增行漏寫導致解析失敗。
  5. 空行分組:邏輯相關聲明組之間空一行,如定位組、盒模型組、字體組。
  6. 縮進 2 空格(或 4 空格,團隊統一),聲明相對選擇器縮進。

聯合定義最佳實踐

.heading-1,
.heading-2,
.heading-3 {
  font-family: var(--font-heading);
  font-weight: 700;
  line-height: 1.2;
  margin-top: 0;
}

壓縮輸出生產環境

開發環境遵循上述展開風格,**構建階段**通過 cssnano、clean-css 壓縮為單行無空格版本,部署至 CDN。源碼保持可讀,產物極致精簡。

工具鏈強制統一

  • Prettier:"singleQuote": true, "tabWidth": 2, "printWidth": 120
  • Stylelint:block-opening-brace-space-before: "always", declaration-colon-space-after: "always", declaration-block-trailing-semicolon: "always"
  • EditorConfig:indent_style = space, indent_size = 2, end_of_line = lf

總結

代碼風格是團隊協作的「交通規則」。統一的展開式多行、選擇器分行、強制尾分號、語義分組,配合 Prettier/Stylelint 自動化執行,將格式爭議降為零,讓 Code Review 聚焦邏輯架構而非空格分號。

copyright © 萬盛學電腦網 all rights reserved