全局SCSS变量文件必须命名为_variables.scss并置于includePaths指定目录(如["src/styles"]),才能被所有组件直接使用$xxx变量;若路径写错(如含./或反斜杠)或未配置在build节点下,会导致生产环境报“Undefined variable”。

全局 SCSS 变量文件必须以下划线开头且放在 includePaths 指定目录中
Angular CLI 的 Sass 编译器只把以 _ 开头的文件识别为 partial(不会单独编译成 CSS),否则会报错或重复引入。变量文件如 _variables.scss 必须放在某个目录下(例如 src/styles/),然后在 angular.json 中通过 stylePreprocessorOptions.includePaths 显式声明该目录:
-
includePaths值必须是数组,内容为相对于项目根目录(即angular.json所在位置)的路径字符串,如["src/styles"] - 不能写成
./src/styles、src\styles或src/styles/_variables.scss—— 后者是文件路径,不是目录 - 若变量文件实际在
src/assets/scss/_theme.scss,则includePaths必须设为["src/assets/scss"],漏掉scss这一级就找不到
@import 'variables' 能工作,是因为 includePaths 改变了查找逻辑
SCSS 的 @import 默认按相对路径解析;但一旦配置了 includePaths,它就变成类似 Node.js 的模块查找:遇到 @import 'variables' 时,会在每个 includePaths 目录下依次找 variables.scss 或 _variables.scss。
- 所以组件里写
@import 'variables'✅,而写@import './styles/_variables'❌——后者绕过includePaths,路径一动就断 - 所有组件 SCSS 都能直接用
$color-primary,前提是:①_variables.scss在includePaths目录里;②styles.scss中已@import 'variables'(仅此处导入一次) - 不推荐在组件里重复
@import,否则可能触发 “Duplicate variable definition” 错误
angular.json 中 styles 数组和 stylePreprocessorOptions 是两个独立配置
styles 数组控制哪些样式文件被打包进最终 styles.css,而 stylePreprocessorOptions 只影响 SCSS 编译期的 @import 解析行为——它们互不替代。
-
styles数组必须包含"src/styles.scss"(或其他入口 SCSS 文件),否则全局样式不会输出到页面 -
stylePreprocessorOptions必须嵌套在projects → [项目名] → architect → build → options下,和styles同级,不是子属性 - 常见错误:把
stylePreprocessorOptions写在serve.options里 →ng serve正常,ng build --prod报Undefined variable: "$xxx"
组件 SCSS 中用变量无需额外 import,但别混淆作用域层级
只要 styles.scss 已导入 _variables.scss,且 includePaths 配置正确,任意组件的 .component.scss 就能直接使用 $color-primary、$spacing-md 等变量——不需要再 @import,也不需要 @use。
立即学习“前端免费学习笔记(深入)”;
- 这是 Sass 的全局作用域注入机制,不是 Angular 的模块系统行为
- 如果组件内定义了同名局部变量(如
$color-primary: #ff0000;),它会覆盖全局值,仅在当前文件生效 - 真正容易被忽略的是:构建后变量失效,90% 是
includePaths路径写错或没重启ng serve;而本地看着正常、生产环境报错,基本说明配置写在了serve而非build节点下


















