CSS 對空白字元(空格、換行、Tab)不敏感,瀏覽器解析結果完全一致。但對開發者而言,格式化風格直接影響維護效率。
/* ✅ 推薦:展開式、語義分組、一致縮排 */
.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;
--myToken ≠ --mytoken(區分大小寫)。@keyframes 名稱:@keyframes fadeIn ≠ @keyframes fadein。@media 特性值:(prefers-color-scheme: dark) 值區分大小寫。class/id 屬性值在 HTML 中區分大小寫,CSS 選擇器匹配時不區分(但建議統一小寫 kebab-case)。/* .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"]
}
}