@use 彻底重构模块系统,变量/混入/函数强制进入命名空间,路径校验严格:文件须以下划线开头加.scss后缀,第三方CSS需包装层,混用@import会导致legacy模式降级。

直接把 @import 换成 @use 会大面积报错,这不是语法替换问题,而是模块系统彻底重做——变量、混入、函数全进命名空间,路径校验变严格,文件命名有硬约束。
为什么@use后所有变量都报Undefined variable
因为 @use 不再向全局注入任何东西。你写的 $primary-color 是在查全局变量,但它实际在命名空间下,比如 colors.$primary-color。
- 默认命名空间 = 文件名(去掉
_和.scss),@use "variables"→ 必须用variables.$spacing-md -
@use "variables" as v→ 必须用v.$spacing-md;写成vars.$spacing-md或$spacing-md都失败 -
@use "mixins" as *在 Dart Sass 5.0+ 中是非法语法,别试 - 旧代码里所有裸
@include clearfix、裸lighten($color, 10%)都得补上前缀,比如mixins.clearfix()、color.lighten()
@use 路径总报 No module with the name 怎么办
这不是“找不到文件”的模糊错误,而是 Dart Sass 对模块路径的硬性校验:它不补扩展名、不猜下划线、不搜子目录、不处理空格或中文。
- 被导入文件必须以下划线开头 +
.scss后缀:_variables.scss✅;variables.scss❌;_variables.css❌ -
@use "variables"→ 自动匹配_variables.scss;写@use "_variables"或@use "variables.scss"全部报错 - 路径是相对当前文件算起:若当前是
src/components/button.scss,要引入src/scss/_colors.scss,必须写@use "../../scss/colors" - 路径含空格或中文 → Dart Sass 直接拒绝解析,不报错也不警告
如何引入第三方 CSS 库(如 normalize.css)
@use 不支持直引纯 CSS 文件,会报 Invalid CSS after ""。必须用本地 Sass partial 做包装层。
- 新建
_normalize-wrapper.scss(注意下划线),内容只有一行:@import "node_modules/normalize.css/normalize.css"; - 然后在业务文件中写:
@use "normalize-wrapper"; - 第三方库如 Bootstrap 4.x 或未适配
@use的版本,@use会直接报错,无法绕过——得等它升级,或临时锁定sass@1.62.1 - 混用
@import和@use会导致整条依赖链降级为不可靠的 legacy 模式:命名空间失效、变量变裸名、@use行为完全不可控
最易被忽略的是:命名空间前缀和调用方式必须字面一致,@use "src/typo" as t 就只能用 t.$font-size-base;拼错、少写、多写一个字符,都只报 Undefined variable,错误信息不会提示“你漏了命名空间”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











