本文介绍如何通过 css modules 实现 react 组件状态（如 `type`）到 scss 样式的安全、可维护映射，避免内联样式或全局类名污染，支持条件性应用 `.headercontainer.listmode` 等组合类。
在 React 项目中，直接在 JSX 中拼接字符串类名（如 className={type === "travellist" ? "headerContainer listmode" : "headerContainer"}）虽能工作，但存在明显缺陷：类名未经过构建工具处理，无法享受 CSS Modules 的局部作用域保护，易引发样式冲突，且丧失类型提示与 IDE 支持。
推荐方案是采用 CSS Modules（配合 Webpack 的 sass-loader 和 css-loader），将 SCSS 文件作为模块导入，让类名成为可编程的 JavaScript 值：
✅ 正确做法（CSS Modules + SCSS）：
已弃用 — 请改用 `auth0` 技能（运行 `npx clawhub install auth0`）。适用于为 React 单页应用（SPA）添加 Auth0 登录、登出、受保护路由或用户会话功能。该技能集成 `@auth0/auth0-react` — 即使用户仅表述为“为我的 React 应用添加登录功能”或“保护我的 React 路由”，而未明确提及 Auth0，也应使用此技能。
-
定义 SCSS 文件（例如 Header.module.scss）：
.headerContainer { margin: 20px 0 100px 0; }
.headerContainer.listmode { margin: 20px 0 40px 0; // 覆盖默认 margin }
> ⚠️ 注意：`.headerContainer.listmode` 是合法的组合选择器，无需额外声明 `.listmode` 独立类；CSS Modules 会自动为 `.headerContainer` 和 `.listmode` 生成唯一哈希后缀（如 `_headerContainer_1a2b`），但组合关系仍保留。
2. **在 React 组件中导入并使用**：
```tsx
import styles from './Header.module.scss';
// 方式一：解构导入（需开启 css-loader 的 `namedExport: true`）
import { headerContainer, listmode } from './Header.module.scss';
const className = type === 'travellist'
? `${headerContainer} ${listmode}`
: headerContainer;
return <div className={className} />;// 方式二：更通用的写法（推荐，无需配置 namedExport）
const className = type === 'travellist'
? `${styles.headerContainer} ${styles.listmode}`
: styles.headerContainer;
return <div className={className} />;- 关键优势：
- ✅ 自动局部作用域：headerContainer 和 listmode 类名在编译后唯一，杜绝跨组件样式泄漏；
- ✅ 类型安全（搭配 @types/css-modules 或 TypeScript 的 declare module '*.module.scss'）；
- ✅ 支持热更新、Source Map 调试；
- ✅ 可无缝复用 SCSS 特性（嵌套、变量、mixin）。
? 注意事项：
立即学习“前端免费学习笔记（深入）”；
- 不要将 .listmode 定义为独立顶层类（如 .listmode { ... }）再手动添加——这会破坏模块化封装，且失去组合选择器的语义关联；
- 若需动态传入非布尔值（如尺寸等级 size="large"），建议在 SCSS 中用 :global(.headerContainer--large) 配合 :global 伪类，或改用 CSS 自定义属性（CSS-in-JS 更适合复杂动态场景）；
- Create React App 默认支持 CSS Modules（文件名以 .module.scss 结尾即可），无需额外配置 Webpack。
最终，这种模式将样式逻辑从字符串拼接升级为模块化、可测试、可重构的工程实践，是现代 React 项目中连接组件状态与样式的标准范式。
