matchAll返回迭代器需转数组才能map；具名捕获组必须通过groups访问；正则必须带g标志；结构化提取应先展开再解构groups。
正则捕获组本身不产生数组，matchAll 返回的是迭代器，而 map 是数组方法——两者不能直接链式调用。要让它们协作，关键在于先将匹配结果转为数组，再对每个匹配项解构其捕获内容。
必须先展开 matchAll 迭代器
str.matchAll(regex) 返回的是 RegExpStringIterator，不是数组。它支持 for...of、扩展运算符 [...] 或手动 .next()，但不能直接接 .map()，否则报错 TypeError: .map is not a function。
- ✅ 正确：用扩展运算符转成数组：
[...str.matchAll(regex)] - ✅ 正确：用数组字面量包装：
[str.matchAll(regex)]（注意这是含一个迭代器的单元素数组，需再展开） - ❌ 错误：
str.matchAll(regex).map(...)—— 迭代器没有map方法
具名捕获组只在 .groups 上，不在匹配数组里
像 (?<id>\d+)</id> 这样的具名捕获组，提取值必须通过 match.groups.id，而不是 match[1] 或 match.index。匹配对象本身只有固定属性（index、input、length、groups），命名组不会“提升”到顶层。
- ✅ 正确解构：
{ groups: { id, name } } - ❌ 常见错误：
{ id, name }—— 这会取undefined，因为id和name不是匹配对象的自有属性 - 普通捕获组（无名）仍保留在
match[1]、match[2]等位置，但具名组优先走groups
全局标志 g 不可省略
matchAll 要返回所有匹配，正则必须带 g 标志。缺 g 时，即使有匹配，迭代器也为空，后续 map 会遍历空数组或报错。
- ✅ 正确：
/id:(?<id>\d+),name:(?<name>\w+)/g</name></id> - ❌ 无效：
/id:(?<id>\d+),name:(?<name>\w+)/</name></id>——matchAll返回空迭代器 -
y（粘性）标志不被matchAll支持，会抛SyntaxError
map 中安全提取结构化数据的写法
把展开后的匹配数组传给 map，回调中直接解构 groups，就能批量生成结构化对象：
const str = "id:123,name:alice id:456,name:bob";
const regex = /id:(?<id>\d+),name:(?<name>\w+)/g;
const results = [...str.matchAll(regex)].map(({ groups }) => ({
id: groups.id,
name: groups.name
}));
// → [{ id: "123", name: "alice" }, { id: "456", name: "bob" }]
- 如果正则可能无匹配，建议加防御：
[...str.matchAll(regex) || []] - 若只需第一个结果，可用解构赋值 + 默认空数组：
const [{ groups } = {}] = [...str.matchAll(regex)]; - 避免在
map回调里重复访问groups多次，提前解构更清晰
