萬盛學電腦網

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

CSS 空格與大小寫規則:代碼格式化、可讀性優化與跨環境一致性

空格在 CSS 中的角色

  • 分隔符:屬性值之間、選擇器組合子之間
  • 可讀性:縮排、換行、對齊讓代碼結構清晰
  • 無語意影響:瀏覽器解析時會忽略多餘空白 (字串值、URL、函數參數除外)

標準格式化風格 (推薦)

/* 展開式:每個聲明獨立一行,適合團隊協作、Git Diff 友善 */
.selector {
  property-1: value-1;
  property-2: value-2;
  property-3: value-3;
}

/* 單行式:屬性極少時可用,如工具類 */
.util { display: flex; align-items: center; }

/* 壓縮式:生產環境構建產物,非手寫 */
.selector{property-1:value-1;property-2:value-2;}

縮排標準

  • **2 空格** 或 **4 空格** (團隊統一),**不要混用 Tab/空格**
  • 左大括號 `{` 前一空格,右大括號 `}` 獨立一行
  • 冒號 `:` 後一空格,分號 `;` 結尾每行
  • 逗號 `,` 後一空格 (多值、多選擇器)

大小寫規則完整對照

項目大小寫敏感度建議慣例
CSS 屬性名❌ 不敏感全小寫 `color`、`background-color`
CSS 關鍵字值❌ 不敏感全小寫 `red`、`solid`、`center`、`auto`
CSS 函數名❌ 不敏感全小寫 `rgb()`、`rgba()`、`calc()`、`var()`
類別選擇器 `.class`✅ 敏感kebab-case 全小寫 `.btn-primary`
ID 選擇器 `#id`✅ 敏感kebab-case 全小寫 `#main-header`
標籤選擇器 (HTML)❌ 不敏感全小寫 `div`、`span`、`section`
標籤選擇器 (XML/XHTML)✅ 敏感需與 XML 標籤大小寫一致
屬性選擇器名 `[attr]`❌ 不敏感 (HTML)全小寫 `[type]`、`[data-value]`
屬性選擇器值 `[attr="val"]`✅ 敏感按實際值大小寫
字體名稱 `font-family`✅ 敏感完全匹配系統字體名 `"Noto Sans TC"`
URL 路徑 `url()`✅ 敏感 (Linux 伺服器)全小寫路徑、實體檔案同步
CSS 變數 `--name`✅ 敏感kebab-case `--color-primary`
@media 查詢關鍵字❌ 不敏感全小寫 `screen`、`print`、`max-width`

HTML class/id 與 CSS 選擇器匹配規則


...
/* CSS - 必須完全匹配大小寫 */ .UserCard { } ✅ 匹配 .usercard { } ❌ 不匹配 #MainContent { } ✅ 匹配 #maincontent { } ❌ 不匹配 /* CSS4 不區分大小寫屬性選擇器 (現代瀏覽器支援) */ [class="UserCard" i] { } ✅ 匹配 (i 標誌) [id="MainContent" i] { } ✅ 匹配

團隊代碼風格規範配置

Stylelint 配置 (推薦)

/* .stylelintrc.js */
module.exports = {
  extends: ['stylelint-config-standard', 'stylelint-config-recess-order'],
  rules: {
    /* 大小寫強制 */
    'selector-class-pattern': '^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$',
    'selector-id-pattern': '^[a-z][a-z0-9]*(-[a-z0-9]+)*$',
    'custom-property-pattern': '^[a-z][a-z0-9]*(-[a-z0-9]+)*$',
    'property-case': 'lower',
    'value-keyword-case': 'lower',
    'function-name-case': 'lower',
    'at-rule-name-case': 'lower',
    
    /* 格式化 */
    'indentation': 2,
    'string-quotes': 'single',
    'no-missing-end-of-source-newline': true,
    'selector-pseudo-class-case': 'lower',
    'selector-pseudo-element-case': 'lower',
    'selector-pseudo-element-colon-notation': 'double',
    
    /* 最佳實踐 */
    'declaration-block-no-duplicate-properties': true,
    'rule-empty-line-before': 'always-multi-line',
    'unit-case': 'lower',
    'color-hex-case': 'lower',
    'color-hex-length': 'short',
  }
};

Prettier 配置 (格式化統一)

/* .prettierrc */
{
  "singleQuote": true,
  "tabWidth": 2,
  "useTabs": false,
  "printWidth": 100,
  "endOfLine": "lf",
  "cssSingleQuote": true
}

編輯器整合 (VS Code)

/* .vscode/settings.json */
{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "stylelint.enable": true,
  "stylelint.validate": ["css", "scss", "less", "vue", "html"],
  "[css]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
  "[scss]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
}

常見格式化爭議與建議

爭議點建議理由
單引號 vs 雙引號單引號JS/TS 一致、減少轉義、Prettier 預設
尾隨逗號加上 (ES5+)Git Diff 乾淨、易新增行
斜線語法空格`font: 1rem/1.5 sans` 無空格標準語法、避免誤讀
顏色縮寫能縮寫則縮寫 (`#fff`)體積、可讀性雙贏
0 值單位省略單位 (`0` 不寫 `0px`)規格允許、體積更小
小數前導 0保留 (`0.5` 不寫 `.5`)可讀性、避免解析歧義
copyright © 萬盛學電腦網 all rights reserved