编写高质量 CSS 样式完全指南

1. 架构与组织

1.1 使用 CSS 方法论

/* BEM 命名规范示例 */
.button { /* Block */ }
.button--primary { /* Modifier */ }
.button__icon { /* Element */ }
.button__icon--large { /* Modifier */ }

/* SMACSS 分类 */
/* Base - 基础样式 */
html, body { margin: 0; padding: 0; }

/* Layout - 布局 */
.l-header, .l-footer, .l-main { ... }

/* Module - 模块 */
.card, .modal, .form { ... }

/* State - 状态 */
.is-active, .is-hidden, .has-error { ... }

/* Theme - 主题 */
.theme-dark { ... }

1.2 目录结构

css/
├── base/              # 基础样式
│   ├── _reset.css    # 重置样式
│   ├── _typography.css # 排版
│   └── _variables.css # 变量
├── components/       # 组件
│   ├── _button.css
│   ├── _card.css
│   └── _form.css
├── layout/           # 布局
│   ├── _grid.css
│   ├── _header.css
│   └── _sidebar.css
├── pages/            # 页面特定
│   ├── _home.css
│   └── _dashboard.css
├── themes/           # 主题
│   └── _dark.css
├── utils/            # 工具类
│   └── _utilities.css
└── main.css          # 主文件

2. 现代 CSS 特性应用

2.1 CSS 自定义属性（CSS 变量）

/* 定义变量 */
:root {
  /* 颜色系统 */
  --color-primary: #4361ee;
  --color-primary-dark: #3a56d4;
  --color-secondary: #7209b7;
  --color-success: #4cc9f0;
  --color-danger: #f72585;
  --color-warning: #f8961e;
  
  /* 字体系统 */
  --font-family-base: 'Inter', -apple-system, system-ui, sans-serif;
  --font-family-heading: 'SF Pro Display', var(--font-family-base);
  --font-size-xs: 0.75rem;   /* 12px */
  --font-size-sm: 0.875rem;  /* 14px */
  --font-size-base: 1rem;    /* 16px */
  --font-size-lg: 1.125rem;  /* 18px */
  --font-size-xl: 1.25rem;   /* 20px */
  
  /* 间距系统 */
  --spacing-xs: 0.25rem;  /* 4px */
  --spacing-sm: 0.5rem;   /* 8px */
  --spacing-md: 1rem;     /* 16px */
  --spacing-lg: 1.5rem;   /* 24px */
  --spacing-xl: 2rem;     /* 32px */
  
  /* 阴影系统 */
  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
  
  /* 圆角 */
  --radius-sm: 0.375rem;
  --radius-md: 0.5rem;
  --radius-lg: 0.75rem;
  --radius-full: 9999px;
  
  /* 过渡动画 */
  --transition-fast: 150ms cubic-bezier(0.4, 0, 0.2, 1);
  --transition-base: 300ms cubic-bezier(0.4, 0, 0.2, 1);
  --transition-slow: 500ms cubic-bezier(0.4, 0, 0.2, 1);
  
  /* 层级 */
  --z-dropdown: 1000;
  --z-sticky: 1020;
  --z-fixed: 1030;
  --z-modal-backdrop: 1040;
  --z-modal: 1050;
  --z-popover: 1060;
  --z-tooltip: 1070;
}

/* 暗色主题 */
[data-theme="dark"] {
  --color-bg-primary: #1a1a1a;
  --color-bg-secondary: #2d2d2d;
  --color-text-primary: #ffffff;
  --color-text-secondary: #b3b3b3;
}

2.2 Flexbox 与 Grid 布局

/* Flexbox 实用类 */
.flex { display: flex; }
.flex-col { flex-direction: column; }
.flex-wrap { flex-wrap: wrap; }
.items-center { align-items: center; }
.justify-center { justify-content: center; }
.justify-between { justify-content: space-between; }
.gap-4 { gap: 1rem; }

/* Grid 布局 */
.grid { display: grid; }
.grid-cols-1 { grid-template-columns: repeat(1, minmax(0, 1fr)); }
.grid-cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
.grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
.grid-cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }

/* 响应式网格示例 */
.grid-container {
  display: grid;
  gap: var(--spacing-md);
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  grid-auto-rows: minmax(100px, auto);
}

/* 卡片网格布局 */
.card-grid {
  display: grid;
  gap: var(--spacing-lg);
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  padding: var(--spacing-lg);
}

3. 现代 CSS 特性

3.1 Container Queries

/* 基于容器宽度的响应式 */
.component {
  container-type: inline-size;
  container-name: component;
}

@container component (min-width: 400px) {
  .component__item {
    display: flex;
    gap: var(--spacing-md);
  }
  
  .component__content {
    flex: 1;
  }
}

@container component (min-width: 600px) {
  .component {
    border-radius: var(--radius-lg);
    padding: var(--spacing-xl);
  }
}

3.2 :has() 选择器

/* 父元素选择器 */
.card:has(.card__image) {
  padding-top: 0;
}

/* 表单验证 */
.form-group:has(input:invalid) {
  --color-border: var(--color-danger);
}

.form-group:has(input:focus) {
  --color-border: var(--color-primary);
  box-shadow: 0 0 0 3px rgba(67, 97, 238, 0.1);
}

/* 动态调整布局 */
.menu:has(.menu__item--active) {
  background: linear-gradient(90deg, 
    var(--color-primary) 0%, 
    rgba(67, 97, 238, 0.1) 100%
  );
}

3.3 Subgrid

/* 嵌套网格对齐 */
.grid-layout {
  display: grid;
  grid-template-columns: 1fr 2fr 1fr;
  gap: var(--spacing-lg);
  padding: var(--spacing-lg);
}

.grid-item {
  display: grid;
  grid-template-rows: subgrid;
  grid-row: span 3; /* 跨越3行 */
}

4. 组件化样式设计

4.1 按钮组件

/* 基础按钮 */
.btn {
  --btn-bg: var(--color-primary);
  --btn-color: white;
  --btn-border: transparent;
  --btn-shadow: var(--shadow-sm);
  
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: var(--spacing-sm);
  padding: var(--spacing-sm) var(--spacing-lg);
  border-radius: var(--radius-md);
  border: 2px solid var(--btn-border);
  background-color: var(--btn-bg);
  color: var(--btn-color);
  font-weight: 600;
  font-size: var(--font-size-sm);
  line-height: 1.5;
  text-decoration: none;
  cursor: pointer;
  transition: all var(--transition-fast);
  box-shadow: var(--btn-shadow);
  user-select: none;
  white-space: nowrap;
  position: relative;
  overflow: hidden;
}

.btn:hover {
  --btn-bg: var(--color-primary-dark);
  transform: translateY(-1px);
  box-shadow: var(--shadow-md);
}

.btn:active {
  transform: translateY(0);
  box-shadow: var(--shadow-sm);
}

.btn:focus-visible {
  outline: 3px solid rgba(67, 97, 238, 0.3);
  outline-offset: 2px;
}

.btn:disabled {
  opacity: 0.6;
  cursor: not-allowed;
  transform: none;
}

/* 按钮变体 */
.btn--secondary {
  --btn-bg: var(--color-secondary);
  --btn-color: white;
}

.btn--outline {
  --btn-bg: transparent;
  --btn-color: var(--color-primary);
  --btn-border: var(--color-primary);
}

.btn--ghost {
  --btn-bg: transparent;
  --btn-color: var(--color-primary);
  --btn-border: transparent;
}

.btn--danger {
  --btn-bg: var(--color-danger);
  --btn-color: white;
}

/* 按钮大小 */
.btn--sm {
  padding: var(--spacing-xs) var(--spacing-md);
  font-size: var(--font-size-xs);
}

.btn--lg {
  padding: var(--spacing-md) var(--spacing-xl);
  font-size: var(--font-size-base);
}

/* 加载状态 */
.btn--loading {
  color: transparent;
}

.btn--loading::after {
  content: '';
  position: absolute;
  width: 1rem;
  height: 1rem;
  border: 2px solid rgba(255, 255, 255, 0.3);
  border-top-color: white;
  border-radius: 50%;
  animation: spin 0.8s linear infinite;
}

@keyframes spin {
  to { transform: rotate(360deg); }
}

4.2 卡片组件

/* 基础卡片 */
.card {
  --card-bg: white;
  --card-border: rgba(0, 0, 0, 0.1);
  --card-shadow: var(--shadow-md);
  
  background: var(--card-bg);
  border: 1px solid var(--card-border);
  border-radius: var(--radius-lg);
  box-shadow: var(--card-shadow);
  overflow: hidden;
  transition: all var(--transition-base);
  position: relative;
}

.card:hover {
  --card-shadow: var(--shadow-lg);
  transform: translateY(-2px);
}

.card--interactive {
  cursor: pointer;
}

.card--interactive:active {
  transform: translateY(0);
}

/* 卡片变体 */
.card--bordered {
  --card-border: var(--color-primary);
  border-width: 2px;
}

.card--flat {
  --card-shadow: none;
  border: 1px solid var(--card-border);
}

/* 卡片元素 */
.card__header {
  padding: var(--spacing-lg) var(--spacing-lg) 0;
  border-bottom: 1px solid var(--card-border);
}

.card__body {
  padding: var(--spacing-lg);
}

.card__footer {
  padding: 0 var(--spacing-lg) var(--spacing-lg);
  border-top: 1px solid var(--card-border);
}

.card__image {
  width: 100%;
  height: 200px;
  object-fit: cover;
}

.card__title {
  font-size: var(--font-size-lg);
  font-weight: 700;
  margin-bottom: var(--spacing-sm);
  color: var(--color-text-primary);
}

.card__description {
  color: var(--color-text-secondary);
  font-size: var(--font-size-sm);
  line-height: 1.6;
}

5. 动画与交互

5.1 现代动画

/* 微交互动画 */
@keyframes fadeIn {
  from { opacity: 0; transform: translateY(10px); }
  to { opacity: 1; transform: translateY(0); }
}

@keyframes slideIn {
  from { transform: translateX(-20px); opacity: 0; }
  to { transform: translateX(0); opacity: 1; }
}

@keyframes scaleIn {
  from { transform: scale(0.9); opacity: 0; }
  to { transform: scale(1); opacity: 1; }
}

@keyframes pulse {
  0%, 100% { opacity: 1; }
  50% { opacity: 0.5; }
}

@keyframes shimmer {
  0% { background-position: -1000px 0; }
  100% { background-position: 1000px 0; }
}

/* 加载动画 */
.skeleton {
  background: linear-gradient(
    90deg,
    rgba(255, 255, 255, 0.1) 25%,
    rgba(255, 255, 255, 0.2) 50%,
    rgba(255, 255, 255, 0.1) 75%
  );
  background-size: 1000px 100%;
  animation: shimmer 2s infinite;
}

5.2 悬停效果

/* 现代化悬停效果 */
.hover-lift {
  transition: transform var(--transition-base), 
              box-shadow var(--transition-base);
}

.hover-lift:hover {
  transform: translateY(-4px);
  box-shadow: var(--shadow-lg);
}

.hover-glow {
  transition: box-shadow var(--transition-base);
}

.hover-glow:hover {
  box-shadow: 0 0 20px rgba(67, 97, 238, 0.3);
}

.hover-scale {
  transition: transform var(--transition-base);
}

.hover-scale:hover {
  transform: scale(1.05);
}

/* 渐变边框悬停 */
.card--gradient {
  position: relative;
  background: var(--card-bg);
  border: 2px solid transparent;
  background-clip: padding-box;
}

.card--gradient::before {
  content: '';
  position: absolute;
  top: -2px;
  right: -2px;
  bottom: -2px;
  left: -2px;
  background: linear-gradient(45deg, 
    var(--color-primary), 
    var(--color-secondary));
  border-radius: var(--radius-lg);
  z-index: -1;
  opacity: 0;
  transition: opacity var(--transition-base);
}

.card--gradient:hover::before {
  opacity: 1;
}

6. 排版系统

6.1 现代排版

/* 排版系统 */
:root {
  /* 字体族 */
  --font-sans: 'Inter', -apple-system, system-ui, sans-serif;
  --font-serif: 'Merriweather', Georgia, serif;
  --font-mono: 'JetBrains Mono', 'Cascadia Code', monospace;
  
  /* 字体大小比例 */
  --font-scale: 1.25; /* 完美四度 */
  --font-base: 1rem;
  
  --font-size-xs: calc(var(--font-base) / var(--font-scale));
  --font-size-sm: var(--font-base);
  --font-size-md: calc(var(--font-base) * var(--font-scale));
  --font-size-lg: calc(var(--font-base) * var(--font-scale) * var(--font-scale));
  --font-size-xl: calc(var(--font-base) * var(--font-scale) * var(--font-scale) * var(--font-scale));
  --font-size-2xl: calc(var(--font-size-xl) * var(--font-scale));
  --font-size-3xl: calc(var(--font-size-2xl) * var(--font-scale));
  
  /* 行高 */
  --line-height-tight: 1.25;
  --line-height-normal: 1.5;
  --line-height-relaxed: 1.75;
  
  /* 字重 */
  --font-weight-light: 300;
  --font-weight-normal: 400;
  --font-weight-medium: 500;
  --font-weight-semibold: 600;
  --font-weight-bold: 700;
  
  /* 字母间距 */
  --letter-spacing-tight: -0.025em;
  --letter-spacing-normal: 0;
  --letter-spacing-wide: 0.025em;
}

/* 排版工具类 */
.text-xs { 
  font-size: var(--font-size-xs); 
  line-height: var(--line-height-tight);
}

.text-sm { 
  font-size: var(--font-size-sm); 
  line-height: var(--line-height-normal);
}

.text-base { 
  font-size: var(--font-size-md); 
  line-height: var(--line-height-normal);
}

.text-lg { 
  font-size: var(--font-size-lg); 
  line-height: var(--line-height-normal);
}

.text-xl { 
  font-size: var(--font-size-xl); 
  line-height: var(--line-height-tight);
}

.text-2xl { 
  font-size: var(--font-size-2xl); 
  line-height: var(--line-height-tight);
  letter-spacing: var(--letter-spacing-tight);
}

.text-3xl { 
  font-size: var(--font-size-3xl); 
  line-height: 1;
  letter-spacing: var(--letter-spacing-tight);
}

/* 字体族类 */
.font-sans { font-family: var(--font-sans); }
.font-serif { font-family: var(--font-serif); }
.font-mono { font-family: var(--font-mono); }

/* 字重类 */
.font-light { font-weight: var(--font-weight-light); }
.font-normal { font-weight: var(--font-weight-normal); }
.font-medium { font-weight: var(--font-weight-medium); }
.font-semibold { font-weight: var(--font-weight-semibold); }
.font-bold { font-weight: var(--font-weight-bold); }

/* 文字修饰 */
.underline-hover {
  text-decoration: none;
  position: relative;
}

.underline-hover::after {
  content: '';
  position: absolute;
  width: 0;
  height: 2px;
  bottom: -2px;
  left: 0;
  background-color: currentColor;
  transition: width var(--transition-base);
}

.underline-hover:hover::after {
  width: 100%;
}

7. 工具类（Utility Classes）

7.1 间距工具

/* 边距 */
.m-0 { margin: 0; }
.m-1 { margin: var(--spacing-xs); }
.m-2 { margin: var(--spacing-sm); }
.m-3 { margin: var(--spacing-md); }
.m-4 { margin: var(--spacing-lg); }
.m-5 { margin: var(--spacing-xl); }

.mx-auto { margin-left: auto; margin-right: auto; }

/* 内边距 */
.p-0 { padding: 0; }
.p-1 { padding: var(--spacing-xs); }
.p-2 { padding: var(--spacing-sm); }
.p-3 { padding: var(--spacing-md); }
.p-4 { padding: var(--spacing-lg); }
.p-5 { padding: var(--spacing-xl); }

/* 间隔 */
.gap-0 { gap: 0; }
.gap-1 { gap: var(--spacing-xs); }
.gap-2 { gap: var(--spacing-sm); }
.gap-3 { gap: var(--spacing-md); }
.gap-4 { gap: var(--spacing-lg); }
.gap-5 { gap: var(--spacing-xl); }

7.2 颜色工具

/* 文字颜色 */
.text-primary { color: var(--color-primary); }
.text-secondary { color: var(--color-secondary); }
.text-success { color: var(--color-success); }
.text-danger { color: var(--color-danger); }
.text-warning { color: var(--color-warning); }
.text-muted { color: var(--color-text-secondary); }

/* 背景颜色 */
.bg-primary { background-color: var(--color-primary); }
.bg-secondary { background-color: var(--color-secondary); }
.bg-success { background-color: var(--color-success); }
.bg-danger { background-color: var(--color-danger); }
.bg-warning { background-color: var(--color-warning); }
.bg-muted { background-color: var(--color-bg-secondary); }

/* 渐变背景 */
.bg-gradient-primary {
  background: linear-gradient(135deg, 
    var(--color-primary), 
    var(--color-secondary)
  );
}

.bg-gradient-subtle {
  background: linear-gradient(135deg, 
    rgba(67, 97, 238, 0.1), 
    rgba(114, 9, 183, 0.1)
  );
}

8. 暗色主题实现

8.1 完整主题系统

/* 主题切换 */
:root {
  color-scheme: light dark;
  
  /* 亮色主题变量 */
  --color-bg-primary: #ffffff;
  --color-bg-secondary: #f8f9fa;
  --color-bg-tertiary: #e9ecef;
  --color-text-primary: #212529;
  --color-text-secondary: #6c757d;
  --color-border: #dee2e6;
  --color-surface: #ffffff;
  --color-elevated: #f8f9fa;
}

@media (prefers-color-scheme: dark) {
  :root {
    /* 暗色主题变量 */
    --color-bg-primary: #121212;
    --color-bg-secondary: #1e1e1e;
    --color-bg-tertiary: #2d2d2d;
    --color-text-primary: #e9ecef;
    --color-text-secondary: #adb5bd;
    --color-border: #495057;
    --color-surface: #1e1e1e;
    --color-elevated: #2d2d2d;
  }
}

[data-theme="dark"] {
  color-scheme: dark;
  --color-bg-primary: #121212;
  --color-bg-secondary: #1e1e1e;
  --color-bg-tertiary: #2d2d2d;
  --color-text-primary: #e9ecef;
  --color-text-secondary: #adb5bd;
  --color-border: #495057;
  --color-surface: #1e1e1e;
  --color-elevated: #2d2d2d;
}

[data-theme="light"] {
  color-scheme: light;
  --color-bg-primary: #ffffff;
  --color-bg-secondary: #f8f9fa;
  --color-bg-tertiary: #e9ecef;
  --color-text-primary: #212529;
  --color-text-secondary: #6c757d;
  --color-border: #dee2e6;
  --color-surface: #ffffff;
  --color-elevated: #f8f9fa;
}

/* 平滑主题切换 */
* {
  transition: background-color 0.3s ease, 
              border-color 0.3s ease,
              color 0.3s ease;
}

9. 现代 CSS 技巧

9.1 滚动条样式

/* 现代滚动条 */
.custom-scrollbar {
  scrollbar-width: thin;
  scrollbar-color: var(--color-primary) transparent;
}

.custom-scrollbar::-webkit-scrollbar {
  width: 8px;
  height: 8px;
}

.custom-scrollbar::-webkit-scrollbar-track {
  background: transparent;
  border-radius: var(--radius-full);
}

.custom-scrollbar::-webkit-scrollbar-thumb {
  background: var(--color-primary);
  border-radius: var(--radius-full);
  transition: background-color var(--transition-fast);
}

.custom-scrollbar::-webkit-scrollbar-thumb:hover {
  background: var(--color-primary-dark);
}

9.2 玻璃态效果

/* 毛玻璃效果 */
.glass {
  background: rgba(255, 255, 255, 0.1);
  backdrop-filter: blur(10px);
  -webkit-backdrop-filter: blur(10px);
  border: 1px solid rgba(255, 255, 255, 0.2);
  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);
}

.glass-dark {
  background: rgba(0, 0, 0, 0.2);
  backdrop-filter: blur(10px);
  -webkit-backdrop-filter: blur(10px);
  border: 1px solid rgba(255, 255, 255, 0.1);
}

9.3 现代表单样式

/* 现代化表单 */
.form-control {
  --input-bg: var(--color-surface);
  --input-border: var(--color-border);
  --input-color: var(--color-text-primary);
  
  width: 100%;
  padding: var(--spacing-sm) var(--spacing-md);
  background: var(--input-bg);
  border: 2px solid var(--input-border);
  border-radius: var(--radius-md);
  color: var(--input-color);
  font-size: var(--font-size-sm);
  transition: all var(--transition-fast);
  outline: none;
}

.form-control:focus {
  --input-border: var(--color-primary);
  box-shadow: 0 0 0 3px rgba(67, 97, 238, 0.1);
}

.form-control:disabled {
  opacity: 0.6;
  cursor: not-allowed;
}

/* 浮动标签 */
.form-group {
  position: relative;
  margin-bottom: var(--spacing-lg);
}

.form-group__input {
  width: 100%;
  padding: var(--spacing-md) var(--spacing-md) var(--spacing-sm);
  background: var(--color-surface);
  border: 2px solid var(--color-border);
  border-radius: var(--radius-md);
  color: var(--color-text-primary);
  font-size: var(--font-size-base);
  transition: all var(--transition-fast);
  outline: none;
}

.form-group__label {
  position: absolute;
  top: var(--spacing-md);
  left: var(--spacing-md);
  color: var(--color-text-secondary);
  font-size: var(--font-size-base);
  pointer-events: none;
  transition: all var(--transition-fast);
  transform-origin: left top;
}

.form-group__input:focus + .form-group__label,
.form-group__input:not(:placeholder-shown) + .form-group__label {
  top: var(--spacing-xs);
  font-size: var(--font-size-xs);
  color: var(--color-primary);
  transform: translateY(-50%) scale(0.85);
}

10. 响应式设计

10.1 移动优先断点

/* 移动优先断点 */
/* 默认样式（移动端） */

/* 小屏幕（平板） */
@media (min-width: 640px) { /* sm */ }

/* 中等屏幕（平板横屏/小桌面） */
@media (min-width: 768px) { /* md */ }

/* 大屏幕（桌面） */
@media (min-width: 1024px) { /* lg */ }

/* 超大屏幕 */
@media (min-width: 1280px) { /* xl */ }

@media (min-width: 1536px) { /* 2xl */ }

/* 实用类示例 */
.responsive-grid {
  display: grid;
  gap: var(--spacing-md);
  grid-template-columns: 1fr;
}

@media (min-width: 768px) {
  .responsive-grid {
    grid-template-columns: repeat(2, 1fr);
  }
}

@media (min-width: 1024px) {
  .responsive-grid {
    grid-template-columns: repeat(3, 1fr);
  }
}

11. 性能优化

11.1 最佳实践

/* 1. 使用CSS变量 */
:root {
  --optimized-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
}

/* 2. 避免使用复杂选择器 */
/* 不好 */
header nav ul li a { }

/* 好 */
.nav-link { }

/* 3. 使用transform和opacity实现动画 */
.element {
  transition: transform var(--transition-base), 
              opacity var(--transition-base);
}

/* 4. 使用will-change优化 */
.animated-element {
  will-change: transform, opacity;
}

/* 5. 内容可见性优化 */
.content-section {
  content-visibility: auto;
  contain-intrinsic-size: 0 500px; /* 估计高度 */
}

12. 可访问性

12.1 无障碍设计

/* 焦点样式 */
:focus-visible {
  outline: 3px solid rgba(67, 97, 238, 0.5);
  outline-offset: 2px;
  border-radius: var(--radius-sm);
}

/* 减少运动 */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

/* 高对比度模式 */
@media (prefers-contrast: high) {
  .button {
    border-width: 2px;
  }
  
  .text-primary {
    color: #0000EE; /* 标准链接蓝色 */
  }
}

/* 屏幕阅读器专用 */
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

关键原则总结：

1. 一致性：使用设计系统，保持样式统一

2. 模块化：组件化CSS，提高可维护性

3. 响应式：移动优先，渐进增强

4. 性能：减少重绘，优化动画

5. 可访问性：支持键盘导航，高对比度

6. 现代特性：拥抱CSS新特性，减少JS依赖

7. 主题化：支持亮色/暗色主题切换

8. 实用类：提供可复用的工具类