Symbol.matchAll是JavaScript内置协议符号，用于统一正则匹配结果迭代，但不支持流式匹配；真正流式匹配需手动管理lastIndex、缓冲跨块数据并封装为异步迭代器。
Symbol.matchAll 本身不是用来“扩展自定义搜索器”的工具，而是 JavaScript 内置的、用于统一迭代正则匹配结果的协议符号。它不能直接“支持流式匹配”，因为原生 matchAll() 返回的是**完整执行后的惰性迭代器**（即仍需一次性扫描整个字符串），不提供暂停、恢复或按块处理的能力。
理解 Symbol.matchAll 的作用边界
该符号定义了对象如何响应 str.matchAll(regex) 调用：
- 若正则表达式对象（
RegExp）有[Symbol.matchAll]方法，就调用它；否则回退到默认行为（即执行全局匹配并返回迭代器）。 - 它不改变匹配引擎的执行方式——仍是一次性遍历全部输入，只是把结果包装成可迭代形式。
- 它不解决大文本、分块读取、边接收边匹配等“流式”场景的核心问题：内存占用、延迟可控、中断/恢复能力。
实现真正流式正则匹配的关键思路
要支持流式（如从 ReadableStream、文件分片、网络 chunk 中逐步匹配），需绕过 matchAll 的限制，自行管理状态：
-
维护 RegExp 的 lastIndex：使用
g或y标志的正则，配合手动设置lastIndex，可在新数据追加后继续上次位置匹配（注意y模式更安全，强制从lastIndex开始）。 -
缓冲跨 chunk 的不完整匹配：正则可能在 chunk 边界被截断（如
/ab+c/遇到"ab"在 chunk1 末尾，"c"在 chunk2 开头），需保留末尾部分参与下一轮匹配。 -
封装为异步迭代器：返回
AsyncIterator，每次next()触发一次增量匹配，适配for await...of。
一个轻量流式匹配器示例（不依赖 Symbol.matchAll）
以下是一个基于 y 标志、支持分段输入的简易流式匹配器：
class StreamingRegexMatcher {
constructor(pattern, flags = 'y') {
this.regex = new RegExp(pattern, flags);
this.buffer = '';
this.lastIndex = 0;
}
push(chunk) {
this.buffer += chunk;
}
*matchAll() {
while (this.lastIndex <= this.buffer.length) {
this.regex.lastIndex = this.lastIndex;
const match = this.regex.exec(this.buffer);
if (!match) break;
yield match;
this.lastIndex = match.index + match[0].length;
}
// 清理已匹配前缀
this.buffer = this.buffer.slice(this.lastIndex);
this.lastIndex = 0;
}
// 重写 Symbol.matchAll 仅用于兼容 str.matchAll(...) 调用（非流式）
[Symbol.matchAll](str) {
return this.regex[Symbol.matchAll](str);
}
}
// 使用：
const matcher = new StreamingRegexMatcher('\d+');
matcher.push('Order ID: 123 and ');
matcher.push('status: 456.');
for (const m of matcher.matchAll()) {
console.log(m[0]); // '123', '456'
}
何时需要（或不需要）重写 Symbol.matchAll
仅当你的自定义正则类需被标准 str.matchAll(yourRegex) 识别时才需实现它，例如：
- 你封装了一个带预编译、缓存、日志的正则类，并希望它无缝接入现有 API。
- 但该实现本身仍是同步、全量的——它不带来流式能力，只是协议兼容。
- 真正的流式逻辑必须放在独立方法中（如上例的
matchAll()），由使用者主动分段调用。
