You need to enable JavaScript to run this app. Node.js服务端JS读取SCSS变量返回空对象的配置排查
优惠活动
大模型
产品
解决方案
定价
更多

Node.js服务端JS读取SCSS变量返回空对象的配置排查

问题核心原因

当前拿到空导出对象是配置缺失导致的必然结果:
:export是CSS Modules体系下,专门用来给JS侧导出样式值的专属语法,而你当前依赖的css-loader@5.x版本,默认关闭了CSS Modules解析能力。这个配置下的编译流程和结果是:

  • sass-loader正常把SCSS代码编译成包含:export块的CSS字符串,这一步没有任何问题
  • css-loader按普通全局CSS规则处理这段字符串,直接把:export块当成无效的自定义规则跳过,全程没有生成对应的JS导出对象
  • 上层的style-loader把处理后的普通CSS规则注入到页面的style标签中,最终你通过import引入SCSS文件时,自然拿到的是空对象

你参考的共享变量教程是基于早年css-loader的默认配置编写的,当时的版本默认开启CSS Modules解析,不需要额外配置就能识别:export块;从css-loader 4.0版本开始,官方把CSS Modules的默认解析规则改成了仅对显式声明的文件生效,直接套老教程的配置就会触发导出为空的问题。

具体修复配置

只需要调整webpack规则里的css-loader参数,显式开启CSS Modules解析即可,不需要升级或更换现有依赖:

// webpack.config.js
module.exports = {
  mode: 'development',
  module: {
    rules: [
      {
        test: /\.scss$/,
        use: [
          "style-loader",
          {
            loader: 'css-loader',
            options: {
              // 显式开启CSS Modules解析,识别:export块
              modules: {
                // 将导出的键名转成驼峰格式,方便JS侧读取
                exportLocalsConvention: 'camelCaseOnly',
                // 变量文件无实际样式类,关闭类名哈希减少冗余代码
                localIdentName: '[local]'
              }
            }
          },
          "sass-loader"
        ]
      }
    ]
  }
};

修改完成后重新执行npx webpack编译,浏览器控制台打印的variables对象就会包含myvar: "100"的映射值,直接读取variables.myvar就能拿到SCSS里定义的变量。

踩坑注意事项
  • 不要搞反loader执行顺序:webpack的loader是从use数组的右侧往左侧依次执行的,必须保证css-loader在sass-loader左侧,否则css-loader拿到的是未编译的SCSS源码,根本无法解析:export块
  • 如果项目中同时存在需要全局生效的普通SCSS文件、和专门用来跨JS共享变量的SCSS文件,不要全量开启CSS Modules,否则原来写的全局类名会被自动加上哈希值导致样式失效。可以单独匹配*.variables.scss这类命名规则的文件,单独开启modules配置
  • 生产构建阶段如果需要把CSS抽成独立文件,搭配mini-css-extract-plugin时要同步保留css-loader的modules配置,否则样式抽离过程中会丢失对应的JS导出
  • 当前解析逻辑下,:export块里的变量值会被统一转成字符串类型,比如定义的数字100,读出来是字符串"100",需要数值类型的话在JS侧自行转换即可,属于正常行为

内容的提问来源于stack exchange,提问作者Stef1611

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 03:06:08