JavaScript 正则 flags 使用指南

这个页面解决什么问题

JavaScript 正则 flags 会改变匹配范围和状态。g 影响多次匹配和 lastIndex，i 忽略大小写，m 改变行首行尾，s 让点号匹配换行，u 影响 Unicode 解析。flags 错误常导致本地测试通过、批量处理失败。

这个页面用于排查日志多行匹配、emoji 字符、循环执行 exec/test、大小写过滤和跨行文本抽取。

快速判断

• 同一个 regex 多次 test 结果交替变化，检查是否使用了 g 并受到 lastIndex 影响。
• ^ 和 $ 在多行文本中行为异常，检查 m。
• 点号不能跨行，检查是否需要 s 或明确字符类。
• 处理 emoji 或 Unicode 属性时，检查 u。

可复制示例：错误输入与修复后输入

坏样例复用带 g 的正则多次 test，可能因为 lastIndex 改变得到不稳定结果。

const r = /error/g; r.test("error"); r.test("error");

const r = /error/; r.test("error"); r.test("error");

如果只是判断是否包含，不需要 g。需要全局匹配时，应该理解 lastIndex 或每次创建新表达式。

诊断步骤

1. 写明目标：单次判断、提取全部、逐行匹配还是跨行匹配。
2. 只添加必需 flags，不要复制别人的完整组合。
3. 用一行和多行样本分别测试 anchors。
4. 用包含 emoji、中文和重音字符的样本测试 Unicode。
5. 在项目代码中检查 regex 是否被复用。

flags 是正则行为的一部分，应与表达式一起进入代码评审。只复制 pattern 而漏掉 flags，或复制 flags 而不理解用途，都可能改变结果。

常见错误表

常见误判

• 认为 g 只是“更完整匹配”。
• 把 m 当成 dotAll。
• 没有测试 Unicode 输入。
• 在 JavaScript 和其他语言之间复制 flags。

不同语言 flags 名称和语义并不完全相同。JavaScript 在线测试结果不能直接代表 PCRE、Python、Go 或 RE2。

隐私、安全和适用边界

用于排查时请使用脱敏样本。不要粘贴访问令牌、Cookie、客户资料、内部域名、未公开商业规则、支付记录或完整生产日志。页面适合处理公开示例、教学片段、复现样本和已经替换真实值的配置。

本页只讨论 JavaScript 正则。生产过滤、安全规则和大规模日志处理应在实际运行环境和数据量下测试。

复制或发布前复核清单

1. 是否知道每个 flag 的必要性。
2. 是否避免不必要的 g。
3. 是否测试多行和跨行输入。
4. 是否测试 Unicode 和 emoji。
5. 是否在目标运行环境复测。
6. 是否记录 pattern 与 flags 一起发布。

相关工具和延伸阅读

参考依据

• MDN Regular expressions：flags 说明。
• MDN RegExp.lastIndex：全局匹配状态。

编辑记录：Ymir Tool editorial review，2026-06-01。本页作为 Sprint 3 新增案例/排错内容发布，目标是把单一工具入口扩展为可复核的任务说明、错误示例和操作边界。