less中map是编译期静态语法糖，非运行时对象；键名须为合法标识符，map-get仅支持字面量键，遍历需先用map-keys/values拆解，嵌套配置须用规则集而非嵌套map。
Less 里没有真正意义上的 Map 数据结构，所谓“映射 Maps”只是编译期静态语法糖，不能当 JSON 或 JS 对象用；强行套用会导致编译失败、键名解析错误或遍历崩溃。
map-get() 只能查固定标识符键，不支持字符串/变量/连字符
你写 @colors: (primary: #007bff, success: #28a745)，那 map-get(@colors, primary) 能工作，但以下全部无效：
-
map-get(@colors, "primary")→ 引号让解析器报错：Expected identifier -
@key: primary; map-get(@colors, @key)→ 变量不会被求值代入，@key就是字面量@key，不是primary -
map-get(@colors, light-primary)→ 连字符不是合法标识符，解析直接中断
本质是 Less 把 (key: value) 当作不可拆解的 token 序列，不是运行时对象。键名必须是字母/下划线开头、不含空格和特殊符号的纯标识符。
.each() 遍历 Map 必须先拆 keys/values，且版本不能低于 3.1.0
想批量生成 .text-primary、.bg-success 这类原子类？别直接写 .each(@colors) { }——Less 3.1+ 仍不接受 map 类型参数，会报 Cannot call method 'each' on null。
- 先用
@keys: map-keys(@colors)和@vals: map-values(@colors)拆成两个 list - 再用
.each(@keys) { }，配合index()和extract()对齐键值 - 执行前务必确认
lessc --version≥ 3.1.0；3.0.x 版本有已知.each()bug
示例中若漏掉 @keys 拆解步骤，或在旧版 Less 下运行，整个构建就会卡住或静默失败。
嵌套主题配置必须用规则集（ruleset），不是嵌套 map
要实现类似 $theme.light.colors.primary 的路径访问，map-get(map-get(@theme, light), colors) 会失败——第二层返回的是规则集或空值，不是可再 map-get 的结构。
- 正确写法是规则集：
@theme: { light: { colors: { primary: #007bff; }; }; };（注意大括号、分号、无逗号） - 访问方式：
@theme.light.colors.primary→ 编译后直接展开为#007bff -
@layer: light; @theme.@{layer}.colors.primary会失败——@{}插值不适用于规则集路径
规则集是唯一支持多层静态访问的方式，但它无法动态切换；所有分支都在编译期确定，和 JS 运行时完全无关。
真正难的不是写多少 map-get()，而是守住“编译期静态”这个边界：所有键名必须写死、所有嵌套必须扁平化或改用规则集、所有遍历必须提前拆解。一旦试图让它“像 JSON 一样用”，就会掉进解析失败、版本兼容、路径静默丢弃的坑里。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
