For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/configure/app/output/disable-css-module-extension.md.
  • 简体中文
  • output.disableCssModuleExtension

    • 类型: boolean
    • 默认值: false

    是否将源码目录下的所有样式文件当做 CSS Modules 模块进行处理。

    在默认情况下,只有 *.module.css 结尾的文件才被视为 CSS Modules 模块。开启该配置项之后,会将源码目录下的所有 *.css 样式文件当做 CSS Modules 模块。

    .sass、.scss 和 .less 文件的处理规则与 .css 文件一致,也会受到 disableCssModuleExtension 的影响。

    Tip

    我们不推荐开启此配置项,因为开启 disableCssModuleExtension 后,CSS Modules 文件和普通 CSS 文件无法得到明确的区分,不利于长期维护。

    示例

    export default {
      output: {
        disableCssModuleExtension: true,
      },
    };

    规则

    以下是对 CSS Modules 判断规则的详细解释:

    未开启 disableCssModuleExtension(默认)

    以下文件会视为 CSS Modules:

    • 所有 *.module.css 文件

    以下文件会视为普通 CSS:

    • 所有 *.css 文件(不含 .module)
    • 所有 *.global.css 文件

    开启 disableCssModuleExtension

    以下文件会视为 CSS Modules:

    • 源码目录下的 *.css 和 *.module.css 文件
    • node_modules 下的 *.module.css 文件

    以下文件会视为普通 CSS:

    • 所有 *.global.css 文件
    • node_modules 下的 *.css 文件(不含 .module)
    Tip

    对于 node_modules 中的 CSS Modules 文件,请始终使用 *.module.css 后缀。