map-get()仅支持单层Map取值，必须传入已定义Map变量和双引号字面量key；查不到key返回null易致编译失败；嵌套需手动拆链或封装map-deep-get；取值带单位不可插值；安全取值前须用map-has-key()校验。
map-get() 不是万能取值器，它只做一件事：从一层 Map 里按 key 拿 value。用错场景或写法，编译直接报错或静默失效。
map-get($map, $key) 的合法调用姿势
必须且只能传两个参数：第一个是已定义的 Map 变量，第二个是字面量 key（带引号）或同作用域下已声明的字符串变量。
- ✅ 正确：
map-get($breakpoints, "md")、$key: "lg"; map-get($breakpoints, $key) - ❌ 错误：
$breakpoints("md")（Sass 语法错误）、map-get($breakpoints, md)（md被当未定义变量）、map-get($breakpoints, 'sm')（单引号在某些 Sass 版本中不被识别，优先用双引号） - ⚠️ 注意：
map-get()查不到 key 时返回null，而null塞进 CSS 属性会触发编译失败，比如width: map-get($sizes, "xxl")→width: null→ 报错"null is not a valid CSS value"
嵌套 Map 不能用点号路径，得拆链或封装
Sass 原生 map-get() 不支持 map-get($config, "colors.primary") 这种写法——它会把整个字符串当一个 key 去查，必然返回 null。
- ✅ 手动拆链：
map-get(map-get($config, "colors"), "primary") - ✅ 封装函数（推荐）：
@function map-deep-get($map, $keys...) { @each $key in $keys { $map: map-get($map, $key); } @return $map; }，然后调用map-deep-get($config, "colors", "primary") - ⚠️ 坑点：中间某层返回了颜色值（如
#fff）而非 Map，下一次map-get()就崩，报Argument '$map' of map-get() must be a map。加守卫：@if type-of($map) != 'map' { @error "Expected map, got #{$map}"; }
map-get 返回值带单位，别手动拼字符串
从 $breakpoints: ("sm": 576px, "lg": 992px) 里取值，map-get($breakpoints, "lg") 返回的是 992px 这个带单位的 Sass 数值，不是字符串 "992px"。
立即学习“前端免费学习笔记（深入）”；
- ✅ 正确：
@media (min-width: map-get($breakpoints, "lg")) { ... }→ 编译为@media (min-width: 992px) - ❌ 错误：
@media (min-width: #{map-get($breakpoints, "lg")})→ 插值会剥离单位，输出(min-width: 992)，非法 CSS - ⚠️ 单位混用风险：如果 Map 里有的值是
576px、有的是36em，后续做+ 1px计算会报 unit mismatch。初始化时统一单位，别留后患。
map-has-key() 是安全取值的前提，不是可选项
只要 map-get() 的 key 来自用户输入、循环变量或配置文件注入，就必须先用 map-has-key() 校验。
- ✅ 守卫写法：
@if not map-has-key($breakpoints, $name) { @error "Unknown breakpoint: #{$name}"; } - ✅ 混合宏内标准结构：
@mixin breakpoint-up($name) { @if not map-has-key($breakpoints, $name) { @error "..."; } @media (min-width: map-get($breakpoints, $name)) { @content; } } - ⚠️ 忽略这步的后果：key 拼错、大小写不一致、键名更新但调用没改，都会导致
map-get()返回null，样式编译失败或静默丢失，调试时很难定位到哪行出了问题。
真正麻烦的不是语法记不住，而是 map-get() 在查不到 key 时不报错、不警告，只默默交出 null——这个值一旦进入计算或 CSS 输出，崩溃就发生在下游，离原始调用点可能隔了七八个文件。
