🔧 配置SCSS
首先,你需要在Vue 3项目中安装必要的依赖并进行配置。
-
安装依赖
在项目根目录下,通过npm或yarn安装SCSS编译器及对应的Webpack加载器:
bashnpm install sass sass-loader --save-dev或者使用yarn:
bashyarn add sass sass-loader --dev这里推荐使用
sass包(Dart Sass),它是Sass的主要实现,更新和支持更好。 -
配置
vue.config.js对于Vue CLI创建的项目,通常在项目根目录下创建或修改
vue.config.js文件,来配置全局注入SCSS变量或混入(mixins)。javascript// vue.config.js const { defineConfig } = require('@vue/cli-service') module.exports = defineConfig({ css: { loaderOptions: { scss: { additionalData: `@import "@/styles/variables.scss";` // 全局变量文件 } } } })通过
loaderOptions.scss.additionalData配置,可以全局引入指定的SCSS文件,使其变量和混入在所有Vue组件中可用。请确保路径正确 ,@/通常指向src目录。
🎨 在组件中使用SCSS
安装并配置好SCSS后,就可以在Vue组件中使用了。
-
基本使用
在Vue单文件组件的<style>标签中,通过lang="scss"属性即可使用SCSS。vue<template> <div class="example"> <h1>Hello SCSS in Vue 3!</h1> </div> </template> <script setup> // 你的脚本逻辑 </script> <style lang="scss" scoped> .example { h1 { color: blue; font-size: 2em; &:hover { color: darkblue; } } } </style>上面的例子展示了SCSS的嵌套和父选择器(
&)用法。
🌍 全局样式与变量管理
为了高效管理项目样式,通常会定义一些全局的SCSS文件。
-
定义全局文件
建议在
src/styles/目录下创建一些通用的SCSS文件,例如:-
_variables.scss: 用于定义全局变量(如颜色、字体等)。scss// _variables.scss $primary-color: #3498db; $secondary-color: #2ecc71; $font-stack: Helvetica, sans-serif; -
_mixins.scss: 用于定义混入(mixins)。scss// _mixins.scss @mixin flex-center { display: flex; justify-content: center; align-items: center; } -
index.scss: 主文件,用于引入其他SCSS局部文件。scss// index.scss @import 'variables'; @import 'mixins';
-
-
全局引入
在
main.js中直接引入主SCSS文件,使其全局生效:javascript// main.js import { createApp } from 'vue' import App from './App.vue' import '@/styles/index.scss' // 引入全局样式 createApp(App).mount('#app')或者在
vue.config.js的additionalData中引入(如前文所述),这种方式更适合全局变量和混入。
📦 使用SCSS模块化
Vue与SCSS结合支持CSS Modules,用于解决样式冲突问题。
在Vue组件的<style>标签上添加module属性,即可启用CSS Modules功能。模板中通过$style对象访问。
vue
<template>
<div :class="$style.example">
<h1>Scoped SCSS Module</h1>
</div>
</template>
<style lang="scss" module>
.example {
background-color: $primary-color; /* 使用全局变量 */
h1 {
color: red;
}
}
</style>
🚀 深度选择器
在Vue中,当<style>标签带有scoped属性时,若要修改子组件样式,需要使用深度选择器。
-
在Vue 2及Vue 3中,推荐使用
::v-deep:vue<style lang="scss" scoped> .container { ::v-deep .child-component { color: red; } } </style> -
::v-deep也可用作组合符::v-deep(.child-component)。 -
旧有的
/deep/选择器在Vue 2.x中可用,但在Vue 3中不推荐使用。
⚠️ 常见问题与技巧
- 版本兼容性 :若遇到
Module build failed: TypeError: this.getResolve is not a function错误,可能是sass-loader版本过高,可尝试降低版本,例如安装npm install sass-loader@7.3.1 --save。 - 路径别名 :在SCSS文件中使用
@import时,@别名可能不直接生效。此时可在additionalData中使用相对路径或绝对路径,或者通过Webpack配置解决。 - 优化建议 :
- 遵循BEM等命名规范,提高代码可读性。
- 将样式按功能拆分为多个小文件(如
_button.scss、_form.scss),通过index.scss统一引入,便于维护。