Vue3引入外部CSS四种方式及scoped作用域选择

脚本专家

Vue3 单文件组件里引入外部 CSS，常见写法看起来只是 import 或 style 的差别，实际关键是作用域。原文给的前提很明确：scoped 的本质是给当前 style 块做组件样式隔离；不在 scoped 中的 CSS 都是全局样式。围绕这一点，四种主流方式可以按“局部引入”和“全局引入”分开看。

一、组件私有样式的两种局部引入

方式1：style src + scoped。这是 Vue 单文件 SFC 原生语法，作用域是局部，仅当前组件生效。特点是 style 标签内部不能写 CSS，只能引入外部文件；编译器直接读取文件，热更新稳定。适合组件样式非常多、全部抽离到外部 CSS、Vue 文件里不再写额外 CSS 的场景；不适合还需要在 Vue 内写少量补充样式的情况。

2. <style src="./login.css" scoped></style>

复制代码

方式2：scoped style 内使用 @import。这是 CSS 原生 @import 语法，作用域仍是局部，仅当前组件生效。与方式1不同的是，导入外部 CSS 后，还可以在当前 style 块继续写补充 CSS。适合大部分样式抽离外部、还需要在 Vue 写少量额外局部样式的场景。注意它依赖构建工具（postcss-import）做内容内联，Vite 没问题；老旧 webpack 偶尔有热更新小问题。

2. <style scoped>
3. @import "./login.css";
4. .desc {
5.   font-size:13px;
6. }
7. </style>

复制代码

上面两种局部引入方式，如果外部 CSS 内部要修改第三方组件，同样需要写 :deep()。

二、全局样式的两种引入方式

方式3：在 script setup 中 import CSS。这是 ES 模块导入 CSS，作用域是全局，整个项目所有组件全部生效，不受 scoped 控制。适合全局样式、重置样式、公共主题样式；严禁用来引入组件专属局部 CSS，否则会污染全局。main.js 中 import 的 CSS，本质就是这种方式，全局生效。

2. <script setup>
3. import '@/assets/reset.css'
4. </script>

复制代码

方式4：不带 scoped 的 style 内使用 @import。作用域是全局样式。适合少量全局 CSS 写在单文件组件内；不适合组件局部样式。

2. <style>
3. @import "@/assets/global.css";
4. </style>

复制代码

三、快速选择决策树

先判断这个 CSS 是组件私有还是全局公共。组件私有、只给当前 Vue 组件使用时：如果组件所有样式全部抽出去，Vue 不再写 CSS，选方式1的 style src + scoped；如果大部分抽出去，还要在 Vue 写少量补充样式，选方式2的 scoped style + @import。全局公共样式、很多页面都要用（重置、主题、全局 class）时，在 main.js 或 script setup 中 import '@/assets/xxx.css'。不要混用踩坑：组件私有 CSS 用 script setup import，会变成全局，产生样式污染；全局 CSS 写在带 scoped 的 style 里面，会被隔离，导致全局失效。

四、真实项目写法示例

示例1：登录页面样式很多，少量补充写在 Vue 内。

2. <style scoped>
3. @import "./login.css";
4. .login-tip {
5.   color:#999;
6. }
7. </style>

复制代码

示例2：用户管理页面所有 CSS 全部抽离，Vue 不写任何 CSS。

2. <style src="./user.css" scoped></style>

复制代码

示例3：全局重置样式 assets/reset.css，在 main.js 中引入。

2. import '@/assets/reset.css'

复制代码

五、补充注意点

scss/less 预处理器下，上面两套局部引入方式同样生效，增加 lang="scss"。例如：

2. <style src="./login.scss" scoped lang="scss"></style>

复制代码

无论方式1还是方式2，外部 CSS 文件内部依然支持 :deep()，用来修改 ElementPlus 组件内部 DOM。不要在同一个组件混合多种局部引入，避免样式顺序混乱。

极简口诀：组件私有样式要拆分，全抽完用 src；还要写点 CSS 就用 @import；全局公共样式，在 js 里面 import。