Nuxt 2.13使用sass-loader 8.0.2通过prependData注入多个SCSS环境变量未生效怎么办
Nuxt 2 多SCSS环境变量全局注入配置方案
对应场景
项目基于Nuxt 2.13、sass-loader 8.0.2版本开发,需要向所有SCSS文件批量注入两类环境变量。此前通过Nuxt构建配置中的loaders.scss.prependData字段,已完成单个SCSS变量的全局注入,基础生效配置如下:
build: { loaders: { scss: { prependData: `$base_url: '${process.env.NODE_ENV == 'development' ? process.env.NUXT_BASE_URL : process.env.SITE_BASE_URL+'/'}';`, } } }
尝试在同一个prependData字段中拼接第二个SCSS变量声明时,出现仅第一个变量可正常被SCSS文件识别、第二个变量无注入效果的问题,对应的失败配置为:
prependData: `$base_url: '${process.env.NODE_ENV == 'development' ? process.env.NUXT_BASE_URL : process.env.SITE_BASE_URL+'/'}';$nuxt_mode: '${process.env.NODE_ENV}';`
失效根因
sass-loader 8.x 本身对prependData参数没有变量数量限制,该字段会把传入的字符串作为合法SCSS代码前置拼接到所有匹配的SCSS文件头部。多变量注入失效基本都是格式问题导致:
- 所有SCSS声明全部压缩在同一行书写时,容易触发语法解析错位,第二个变量声明会被误判为无效代码,被编译器直接丢弃
- 动态拼接的环境变量值如果包含未转义的单引号,会提前闭合SCSS字符串的外层引号,导致后续代码解析断裂
正确配置实现
调整prependData内的SCSS代码格式,为每一条变量声明保留独立的行分隔,避免单行拼接带来的解析错位,同时对动态拼接的环境变量值做基础转义处理,修正后的配置代码如下:
build: { loaders: { scss: { prependData: ` $base_url: '${process.env.NODE_ENV === 'development' ? process.env.NUXT_BASE_URL : `${process.env.SITE_BASE_URL}/`}'; $nuxt_mode: '${process.env.NODE_ENV}'; ` } } }
操作注意点
- 这类构建层的loader配置属于服务启动时的初始化逻辑,修改后必须重启Nuxt开发服务才能生效,热更新不会重载这类配置
- 若需注入更多环境变量,直接在
prependData的字符串块内按SCSS语法新增声明即可,无数量上限 - 后续如果升级sass-loader到9.x及以上版本,需要将对应配置字段从
prependData替换为additionalData
内容的提问来源于stack exchange,提问作者Mojtaba Barari
相关产品推荐
相关产品推荐

