空格在 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`) | 可讀性、避免解析歧義 |