CSS 全局命名空間、樣式覆蓋、副作用難追蹤,團隊協作時極易產生「不敢刪、不敢改、不敢動」的脆弱代碼庫。本文提煉企業級 CSS 工程化規範,涵蓋命名、架構、流程、工具鏈。
stylelint-config-standard + stylelint-config-rational-order 屬性排序)@charset "UTF-8";.block { } /* 獨立組件塊 */
.block__element { } /* 組件內部元素,雙下劃線 */
.block--modifier { } /* 狀態/變體,雙連字符 */
.block__element--modifier { } /* 元素變體 */
/* 實例 */
.card { }
.card__image { }
.card__title { }
.card--featured { }
.card__image--rounded { }
| 層級 | 前綴/命名空間 | 職責 | 示例 |
|---|---|---|---|
| 設定層 | 無(CSS 變量) | 設計 Token | --color-brand-500, --space-4 |
| 通用層 | u- / util- | 單一職責工具類 | u-mt-4, u-d-flex, u-text-center |
| 對象層 | o- | 佈局骨架、無業務語義 | o-container, o-grid, o-media |
| 組件層 | 無前綴(BEM Block) | 業務組件 | .card, .btn, .modal |
| 工具/狀態 | is-, has- | JS 切換狀態 | .is-active, .is-loading, .has-error |
| JS 鉤子 | js- | 僅供 JS 選擇,絕不寫樣式 | .js-modal-trigger, .js-form-submit |
| 測試鉤子 | data-testid | E2E 測試選擇器 | data-testid="submit-btn" |
myapp-、ui-。:where(),業務樣式輕鬆覆蓋。/* main.css 入口順序:由低優先級、廣泛影響 → 高優先級、局部具體 */
@import 'settings/tokens'; /* 設計 Token,無選擇器 */
@import 'settings/breakpoints'; /* 媒體查詢斷點 */
@import 'tools/helpers'; /* Mixin/Function 或通用工具類 */
@import 'generic/reset'; /* Normalize/Reset */
@import 'generic/normalize'; /* 統一瀏覽器默認 */
@import 'elements/typography'; /* 裸標籤排版 */
@import 'elements/forms'; /* 裸標籤表單 */
@import 'objects/container'; /* 佈局容器 */
@import 'objects/grid'; /* 網格系統 */
@import 'objects/media'; /* 圖文混排對象 */
@import 'components/button'; /* 具體組件 */
@import 'components/card';
@import 'components/modal';
@import 'utilities/spacing'; /* 高優先級工具類 */
@import 'utilities/display';
@import 'utilities/visibility';
settings/、generic/、objects/,定義 Token、佈局原語、全局重置。components/xxx.css,遵循 BEM、Token 使用、無障礙、響應式、暗色模式清單。main.css / 組件樣式?!important、z-index: 9999、魔法數字?font-family 必須轉 Unicode 碼(\5FAE\8F6F\96C5\9ED1)或使用 @font-face 本地加載,避免編碼亂碼。.icon 基礎類。sprite.svg(<symbol id="icon-xxx">),<use xlink:href="#icon-xxx"> 引用。srcset。_hack、*hack、\9、@media screen\0 等 Hack。@supports 特性檢測,提供現代寫法 + 兜底。<meta http-equiv="X-UA-Compatible" content="IE=7">:污染渲染模式,阻礙現代特性。png-8 / WebP lossless,體積小、無鋸齒。png-24 / WebP lossy,IE6 早已棄用,無需 AlphaImageLoader 濾鏡。@import 在非構建環境(阻塞渲染)。position: absolute/fixed、float 破壞正常流,優先 Flex/Grid。filter: blur()、box-shadow 大範圍高模糊在滾動容器上(掉幀)。media="print" onload="this.media='all'" 異步加載。/* ===================================
Component: Card
Description: 通用卡片容器,支援圖片、標題、操作區
Dependencies: _tokens.css, _media.css
=================================== */
.card { }
/* === Section: Layout === */
.card__media { }
/* === Section: States === */
.card--interactive:hover { }
# package.json scripts
"lint:css": "stylelint \"src/**/*.{css,vue,scss}\" --fix",
"test:css": "npm run lint:css && npm run test:visual-regression",
# Git Hooks (husky)
"pre-commit": "lint-staged"
# lint-staged config
{
"*.{css,scss,vue}": ["stylelint --fix", "prettier --write"]
}
「CSS 規範的本質是『約束釋放自由』:用極少的強制規則(命名、架構、Token),換取團隊在業務邏輯上的極大自由度與並行開發效率。」