在 vite 项目中配置 sass,需要安装 sass 依赖并在 vite.config.js 中通过 css.preprocessoroptions 设置全局变量或导入文件。vite 默认支持 sass,无需额外加载器,只需确保安装了 sass 包即可使用 .scss 或 .sass 文件。

Vite 如何引入全局 Sass 变量?
通过 css.preprocessorOptions.scss.additionalData 选项,可以在每个 .scss 文件编译前自动注入变量或混合宏。这允许你在组件样式中直接使用全局定义的变量,而无需在每个文件中手动 @import。

import { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
export default defineConfig({
plugins: [vue()],
css: {
preprocessorOptions: {
scss: {
additionalData: `@use "./src/styles/variables" as *;`
}
}
}
});
上述配置将 variables.scss 中的内容注入到所有 SCSS 文件中。假设 variables.scss 定义了 $primary-color: #007bff;,则在任意组件的 中可直接使用 $primary-color。
Sass 配置中如何处理模块隔离?
使用 @use 语法替代旧的 @import 可以避免命名冲突和重复计算。在 additionalData 中使用 @use 并指定别名,可以确保变量作用域清晰。Vite 基于 esbuild 和 sass 编译器,推荐使用现代 Sass 模块系统。

// src/styles/variables.scss
$primary-color: #007bff;
$font-size-base: 16px;
// src/App.vue
<style lang="scss" scoped>
.button {
color: $primary-color; // 直接访问,因为已通过 additionalData 注入
font-size: $font-size-base;
}
</style>
这种配置方式确保了全局变量的可用性,同时保持了代码的模块化。如果项目较大,建议将变量按功能拆分文件,并通过 additionalData 统一注入入口文件。
当 Sass 变量未正确注入时会发生什么?
如果 additionalData 路径错误或文件不存在,Vite 编译会失败并抛出 Undefined variable 错误。检查文件路径是否相对于 vite.config.js 或项目根目录正确。此外,确保 sass 包已安装,否则 Vite 无法处理 .scss 文件。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











