萬盛學電腦網

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

CSS 空格與大小寫規範:可讀性、壓縮、團隊協作的最佳實踐

空格:不影響瀏覽器渲染,決定代碼可讀性

CSS 對空白字元(空格、換行、Tab)不敏感,瀏覽器解析結果完全一致。但對開發者而言,格式化風格直接影響維護效率。

推薦格式化風格(Prettier / Stylelint 標準)

/* ✅ 推薦:展開式、語義分組、一致縮排 */
.card {
  display: flex;
  flex-direction: column;
  gap: 1rem;

  padding: 1.5rem;
  border: 1px solid var(--border-color);
  border-radius: var(--radius-lg);
  background: var(--bg-color);

  font: 1rem/1.6 var(--font-sans);
  color: var(--text-primary);
}

.card__title {
  margin: 0;
  font-size: 1.25rem;
  font-weight: 600;
}

避免的反模式

/* ❌ 壓縮在一行:難讀、難 diff、難合併 */
.card{display:flex;flex-direction:column;gap:1rem;padding:1.5rem;border:1px solid var(--border-color);border-radius:var(--radius-lg);background:var(--bg-color);font:1rem/1.6 var(--font-sans);color:var(--text-primary);}

/* ❌ 亂序、無分組、隨意縮排 */
.card{ background:var(--bg-color);  display: flex;   border:1px solid var(--border-color);  padding:1.5rem; border-radius:var(--radius-lg);  gap:1rem; flex-direction: column; font:1rem/1.6 var(--font-sans); color:var(--text-primary); }

大小寫:屬性名、關鍵字建議小寫;自定義識別符區分大小寫

瀏覽器層面:不區分大小寫

  • COLOR: RED;、color: red;、Color: Red; 效果相同。
  • #MyId、#myid 在 CSS 選擇器中視為相同(HTML id 屬性區分大小寫,但 CSS 匹配時不區分)。

團隊規範層面:強制小寫

/* ✅ 規範:所有屬性名、關鍵字、單位、十六進制顏色 全部小寫 */
color: #ff33aa;
margin: 0 auto;
font-family: "pingfang tc", "microsoft jhenghei", sans-serif;

/* ❌ 混用大小寫:diff 雜訊大、認知負擔高 */
Color: #FF33AA;
Margin: 0 Auto;
Font-Family: "PingFang TC", "Microsoft JhengHei", sans-serif;

例外:自定義識別符區分大小寫

  • CSS 變數:--myToken ≠ --mytoken(區分大小寫)。
  • @keyframes 名稱:@keyframes fadeIn ≠ @keyframes fadein。
  • @media 特性值:(prefers-color-scheme: dark) 值區分大小寫。
  • HTML class/id 屬性值在 HTML 中區分大小寫,CSS 選擇器匹配時不區分(但建議統一小寫 kebab-case)。

工程化強制規範:Prettier + Stylelint + Git Hooks

/* .prettierrc */
{
  "singleQuote": true,
  "tabWidth": 2,
  "printWidth": 100,
  "css": { "quoteStyle": "single" }
}

/* .stylelintrc */
{
  "extends": ["stylelint-config-standard", "stylelint-config-prettier"],
  "rules": {
    "selector-class-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$",
    "custom-property-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
    "keyframes-name-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
    "color-hex-case": "lower",
    "color-hex-length": "long",
    "unit-case": "lower",
    "function-name-case": "lower"
  }
}

/* package.json */
{
  "scripts": {
    "lint:css": "stylelint \"**/*.css\"",
    "format": "prettier --write \"**/*.{css,scss,vue,jsx,tsx}\""
  },
  "husky": {
    "hooks": {
      "pre-commit": "lint-staged"
    }
  },
  "lint-staged": {
    "*.{css,scss}": ["stylelint --fix", "prettier --write"]
  }
}

總結

  • 空格:瀏覽器不在意,團隊要在意。強制統一格式化工具(Prettier),消除風格爭論。
  • 大小寫:瀏覽器不區分,規範強制小寫(屬性、關鍵字、單位、Hex)。自定義識別符(變數、keyframes、media 特性值)區分大小寫,規範用 kebab-case。
  • 工程化:Prettier 格式化 + Stylelint 規則檢查 + Husky 提交前攔截,零成本維持代碼庫整潔一致。
copyright © 萬盛學電腦網 all rights reserved