萬盛學電腦網

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

CSS 代碼一致性原則:制定團隊風格指南、自動化工具鏈與審查機制

一致性 > 風格優劣

單行 vs 多行、字母序 vs 邏輯序、Tab vs Space —— 沒有絕對正確,只有「全專案統一」才正確。不一致帶來的認知負荷遠超風格本身優劣。

實用混合策略(作者採用)

/***** 單行:≤3 條聲明 *****/
.btn { display: inline-block; padding: .5em 1em; }

/***** 多行:>3 條聲明 *****/
.card {
  position: relative;
  border-radius: 8px;
  box-shadow: 0 2px 8px rgba(0,0,0,.1);
  padding: 1.5rem;
  transition: transform .2s, box-shadow .2s;
}

/***** 巢狀規則:反映 DOM *****/
.nav {
  display: flex;
  &-item { flex: 1; }
  &-link { color: inherit; }
}

團隊風格指南必備項目

  1. 格式化:縮排、換行、空格、引號、分號、顏色格式(hex vs rgb)
  2. 排序規則:推薦 Concentric CSS(定位 → 盒模型 → 邊框/背景 → 字體/文字 → 裝飾 → 其他)或 字母序(工具友好)
  3. 命名規範:BEM、ITCSS、Utility 前綴、JS 掛鉤前綴
  4. 註釋標準:區塊標題、狀態說明、Hack 理由、TODO 標記
  5. 單位策略:rem/em/%/vw/vh、避免 px 鎖死、0 省略單位
  6. 檔案組織:ITCSS 7 層(Settings、Tools、Generic、Elements、Objects、Components、Utilities)

自動化強制一致性

/* .stylelintrc.json 關鍵規則 */
{
  "rules": {
    "indentation": 4,
    "string-quotes": "double",
    "color-hex-case": "lower",
    "color-hex-length": "short",
    "selector-class-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$",
    "property-no-unknown": true,
    "declaration-block-semicolon-newline-after": "always",
    "rule-empty-line-before": "always-multi-line"
  }
}

配合 Prettier 格式化、Husky + lint-staged 提交前攔截、CI 檢查 門檻,實現「無法提交不合規代碼」。

Code Review 關注點

  • 是否遵循團隊風格指南(工具已擋 90%)
  • 命名是否語義化、可搜尋、無縮寫歧義
  • 是否引入新的全域污染或過度權重
  • 響應式、無障礙、效能是否達標
copyright © 萬盛學電腦網 all rights reserved