用@each遍历Sass Map生成断点类需用#{}插值避免非法CSS，键名连字符无需引号，统一用无引号标识符；嵌套Map中map-get返回null主因是键类型不一致；map-values()不适合需键上下文的场景，应优先遍历Map本身；map-merge为浅合并，覆盖整层键值，深合并需自定义函数。
如何用 @each 遍历 Sass Map 生成断点类？
直接上手：Sass 的 map 本质是键值对集合，配合 @each 可批量输出响应式工具类（如 .p-4、.mt-sm-2），避免手动重复写几十个规则。
常见错误是把断点名当字符串硬编码进选择器，结果生成了 .mt-"sm"-2 这种非法 CSS —— 原因是没用 #{} 插值；另一个坑是 Map 的键含连字符（如 sm、md）时，误用 map-keys($breakpoints) 返回的不是纯字符串列表，而是带引号的 Sass 值，需配合 inspect() 或直接遍历键值对。
- 推荐结构：
$breakpoints: (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px); - 遍历时用
@each $breakpoint, $value in $breakpoints，而非先取 keys 再查 value - 生成类名时必须插值：
.mt-#{$breakpoint}-2，不能写成.mt-$breakpoint-2 - 注意：
$breakpoint是 key（如sm），$value是对应像素值（如576px），别在媒体查询里错用 key 当数值
为什么 map-get() 在嵌套 Map 中容易返回 null？
嵌套 Map（比如 $spacers: (xs: 0.25rem, sm: 0.5rem, ...) 和 $theme: (spacers: $spacers, colors: $colors)）中，map-get($theme, spacers) 返回的是子 Map，但若后续再调 map-get(map-get($theme, spacers), xs) 却得 null，大概率是键类型不一致：一个用字符串 "xs"，一个用无引号标识符 xs。
Sass 对键区分类型，map-get($map, "xs") 和 map-get($map, xs) 查的是两个不同键。调试时可用 inspect(map-keys($map)) 看实际键的格式。
立即学习“前端免费学习笔记（深入）”；
- 统一用无引号键定义 Map：
(xs: 0.25rem, sm: 0.5rem)，调用时也用xs（不加引号） - 若必须用字符串键（如动态拼接），则全部显式加引号并保持一致
- 嵌套访问建议封装函数：
@function theme-get($section, $key) { @return map-get(map-get($theme, $section), $key); }
用 @for + map-values() 生成栅格列宽时要注意什么？
想按 $grid-columns: 12 和 $col-widths: (sm: 100%, md: 50%, lg: 33.333%) 输出 .col-sm-6、.col-md-4 类？别直接 @for $i from 1 through $grid-columns 然后套用 map-values() —— 因为 map-values() 返回的是无序列表，长度和顺序不可靠，且无法关联到当前循环变量 $i。
正确做法是遍历 Map 本身，用 map-keys() 拿出断点名，再用 map-get() 取对应宽度值，最后结合 $i 计算比例：
@each $breakpoint, $width in $col-widths {
@media (min-width: map-get($breakpoints, $breakpoint)) {
@for $i from 1 through $grid-columns {
.col-#{$breakpoint}-#{$i} {
flex: 0 0 calc(#{$width} / #{$grid-columns} * #{$i});
}
}
}
}-
map-values()仅适合提取所有值做简单操作（如生成颜色变量），不适合需要键上下文的场景 - 媒体查询内嵌
@for会显著增加编译体积，$grid-columns: 12会生成 12 × 断点数 条规则，上线前确认是否真需要全量 - 计算列宽优先用 CSS 自适应（
flex: 1或grid），Sass 生成仅用于兼容老浏览器
Map 合并时 map-merge() 的覆盖逻辑和副作用
map-merge($base, $override) 是浅合并：只替换顶层同名键，不会递归合并嵌套 Map。比如 $base: (colors: (primary: blue), spacing: 1rem) 和 $override: (colors: (secondary: red)) 合并后，colors 整个被替换成新 Map，primary 就丢了。
这导致主题切换或组件库定制时，局部覆盖配置反而清空了其他设置。调试时发现某色值突然变成默认值，八成是 map-merge() 覆盖了整层。
- 需要深合并就自己写递归函数，或改用现代方案（CSS 自定义属性 + JS 控制）
- 生产环境慎用
!default和map-merge()混用，!default不影响已声明的 Map，但map-merge()会彻底重写 - 临时调试可加断言：
@if not map-has-key($merged, colors) { @error "colors key missing after merge"; }
Map 的真正难点不在语法，而在维护键的语义一致性 —— 同一个 sm 在断点、间距、字体大小里代表的物理含义是否对齐，这个没法靠编译器检查，只能靠团队约定和文档约束。
