正则表达式的可维护性：如何为复杂的正则添加注释？-js教程-PHP中文网

为复杂正则添加注释的核心是清晰表达匹配意图与设计原因，常用宽松模式分行+“#”注释、内联(?#...)注释、拆解变量+外部注释三种方式，并辅以regex101等工具验证。

正则表达式的可维护性：如何为复杂的正则添加注释？

为复杂正则添加注释，核心是让别人（包括未来的你）一眼看懂“它在匹配什么”和“为什么这么写”。不靠猜，不靠调试，靠清晰的结构和意图表达。

用宽松模式分行书写 + # 注释

这是最常用、最直观的方式，适用于 Python（re.VERBOSE）、PHP（/pattern/x）、Perl、Ruby、Java（Pattern.COMMENTS）等支持该特性的语言。JavaScript 原生不支持，但可用 XRegExp 库补上。

开启后，正则中的空格、制表符、换行会被忽略，# 后内容全当注释，直到行尾：

Hedra

Hedra是一款用于生成说话角色、口型同步和角色视频的 AI 视觉创作平台。

下载

/^
  [a-zA-Z0-9._%+-]+  # 用户名部分：字母、数字、常见符号
  @                   # 必须有 @ 符号
  [a-zA-Z0-9.-]+      # 域名主体：字母、数字、点、连字符
  \.                  # 字面量点号
  [a-zA-Z]{2,}        # 顶级域名：至少两个字母
$/x

注意：要匹配实际空格，得写成 \s 或 [ ]，不能直接敲空格
要匹配字面量 #，必须放进字符组写成 [#] 或转义为 \#

内联注释 (?#...)

所有主流正则引擎都支持，无需开启额外标志，适合嵌入单行表达式中作简短说明：

/\d{4}-(?#年)\d{2}-(?#月)\d{2}(?#日)/

注释内容写在 (?# 和 ) 之间，不参与匹配
适合补充局部含义，比如解释某个量词或字符类的作用
不适合大段说明，否则会让整行变得拥挤难读

拆解变量 + 外部注释（推荐用于 JS/TS）

JavaScript 原生不支持宽松模式，但可以靠代码组织弥补：把正则拆成带语义的常量，配合清晰的变量名和行尾注释：

const usernamePart = /[a-z0-9._%+-]+/i; // 支持大小写字母、数字及常见分隔符
const domainPart   = /[a-z0-9.-]+\.[a-z]{2,}/i; // 域名+点+TLD
const emailRegex   = new RegExp(`^${usernamePart.source}@${domainPart.source}$`);