CSS Academy · 课时

CSS Modules：局部作用域样式

Q: 「CSS Modules：局部作用域样式」这节课中我会学到什么？

在构建设置中使用 CSS Modules，自动将类名限制在组件的局部作用域内。 你通过在浏览器中直接运行的动手代码来练习 CSS Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

在构建设置中使用 CSS Modules，自动将类名限制在组件的局部作用域内。

CSS Modules：局部作用域样式 是 CoddyKit 上的免费 CSS Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 CSS Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 CSS Academy 课程共包含 4 节课。

什么是 CSS 模块？

CSS 模块会自动将 CSS 类名限制在其定义所在的组件文件中。每个类名都会在构建时转换为唯一标识符，从而避免样式泄漏到全局。

文件命名约定

将 CSS 文件命名为 .module.css（使用 Sass 时命名为 .module.scss）：

/* Button.module.css */
.button {
  background: royalblue;
  color: white;
  padding: 10px 20px;
  border-radius: 4px;
}

导入 CSS 模块

将模块作为 JavaScript 对象导入。类名会成为对象属性：

import styles from './Button.module.css';

function Button({ children }) {
  return <button className={styles.button}>{children}</button>;
}
// Renders as: class="Button_button__aB2cD" (unique hash)

组合类

使用 composes 从另一个模块扩展类：

/* Button.module.css */
.primary {
  composes: base from "./Base.module.css";
  background: royalblue;
}

全局类

使用 :global() 可针对特定类退出局部作用域：

/* styles.module.css */
.container :global(.third-party-class) {
  /* targets third-party className without scoping */
  color: red;
}

在 Vite 中使用 CSS 模块

Vite 内置了对 CSS 模块的支持。匹配 *.module.css 的文件会被自动处理：

// vite.config.js
export default {
  css: {
    modules: {
      localsConvention: 'camelCase' // .my-class → styles.myClass
    }
  }
}

在 webpack 中使用 CSS 模块

在 css-loader 配置中启用模块：

{
  loader: 'css-loader',
  options: {
    modules: {
      localIdentName: '[name]__[local]--[hash:base64:5]'
    }
  }
}

类名组合

使用模板字面量或 clsx/classnames 库组合多个模块类：

import styles from './Card.module.css';
import clsx from 'clsx';

function Card({ featured }) {
  return (
    <div className={clsx(styles.card, featured && styles.featured)}>
      Content
    </div>
  );
}

无运行时开销

CSS 模块完全在构建时解析，不会产生运行时 JavaScript 开销。输出结果是类名已重命名的标准 CSS。因此，它们非常适合对性能敏感的应用。

TypeScript 支持

使用 typed-css-modules，或使用 Vite 的 cssModuleTypes 配置，为 CSS 模块生成 TypeScript 类型定义，从而以类型安全的方式访问类名。

CSS 模块与 CSS-in-JS 的比较

CSS 模块的特点：

仅在构建时处理——无运行时 JS 开销
可与标准 CSS/Sass 集成——语法熟悉
无法通过 JS 插值实现动态样式
对于主题驱动的动态样式，不如 styled-components/Emotion 灵活

快速检查

CSS 模块如何防止两个不同组件文件之间发生类名冲突？

回顾

CSS 模块会在构建时将类名转换为唯一标识符，从而自动限制类名的作用域。您可以将其作为 JavaScript 对象导入，并以属性方式访问类。使用 :global() 可退出局部作用域并创建全局选择器，使用 composes 可组合类。零运行时开销以及对完整 CSS/Sass 语法的支持，使 CSS 模块成为静态样式领域中轻量的 CSS-in-JS 替代方案。

常见问题解答

「CSS Modules：局部作用域样式」课时是免费的吗？

是的 — 「CSS Modules：局部作用域样式」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 CSS Academy 课程的其余内容，请升级到 CoddyKit PRO。 CSS Academy 课程共包含 4 节课。

「CSS Modules：局部作用域样式」这节课中我会学到什么？

在构建设置中使用 CSS Modules，自动将类名限制在组件的局部作用域内。你通过在浏览器中直接运行的动手代码来练习 CSS Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 CSS Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 CSS Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「CSS Modules：局部作用域样式」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 CSS Academy 课中编写并运行代码吗？

能。每节 CSS Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 CSS Academy