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
相关产品推荐
相关产品推荐

