隨著專案增長,單一巨型 CSS 檔案導致:尋找困難、衝突頻發、重構恐懼、新人上手陡峭。良好架構 = 可預測的檔案位置 + 可控的層疊順序 + 清晰的依賴關係。
由 Harry Roberts 提出,按通用性→具體性、低優先級→高優先級、隱式→顯式倒三角分層:
_settings.colors.scss、_settings.spacing.scss_tools.mixins.scss、_tools.functions.scss_generic.reset.scss、_generic.normalize.scss_elements.headings.scss、_elements.forms.scss_objects.container.scss、_objects.grid.scss、_objects.media.scss_components.buttons.scss、_components.modal.scss.u-mt-4、.u-hidden、.u-text-center),允許 !important_utilities.spacing.scss、_utilities.display.scss@use 'settings/*' as *;
@use 'tools/*' as *;
@use 'generic/*' as *;
@use 'elements/*' as *;
@use 'objects/*' as *;
@use 'components/*' as *;
@use 'utilities/*' as *;
嚴禁跨層 @forward 或 @use 逆向依賴,防止循環引用與層疊失控。
/* ==========================================================================
Component: Button — 可互動按鈕元件
========================================================================== */
/* Base: 預設樣式 ........................................................ */
.btn { ... }
/* Variant: 主要/次要/危險 ................................................. */
.btn--primary { ... }
.btn--danger { ... }
/* State: hover/focus/disabled/loading ................................... */
.btn:disabled { ... }
/* Layout: 尺寸變體 ...................................................... */
.btn--sm { ... }
.btn--lg { ... }
=== 分隔,子區段用 ... 對齊/* [Note] reason */、Hack 加 /* [Hack] browser bug */components/ → Objects/Utilities 混淆