为复杂正则添加注释的核心是清晰表达匹配意图与设计原因，常用宽松模式分行+“#”注释、内联(?#...)注释、拆解变量+外部注释三种方式，并辅以Regex101等工具验证。
为复杂正则添加注释，核心是让别人（包括未来的你）一眼看懂“它在匹配什么”和“为什么这么写”。不靠猜，不靠调试，靠清晰的结构和意图表达。
用宽松模式分行书写 + # 注释
这是最常用、最直观的方式，适用于 Python（re.VERBOSE）、PHP（/pattern/x）、Perl、Ruby、Java（Pattern.COMMENTS）等支持该特性的语言。JavaScript 原生不支持，但可用 XRegExp 库补上。
开启后，正则中的空格、制表符、换行会被忽略，# 后内容全当注释，直到行尾：
/^
[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}$`);- 变量名本身已是文档，如 usernamePart 比 part1 强十倍
- 注释聚焦“为什么允许这些字符”，而不是重复语法（如“+ 表示一个或多个”不用写）
- 避免内联正则，比如 /\d+/.test(str) → 提前定义 const digits = /\d+/;
用专用工具辅助理解
人工写注释很重要，但工具能帮你验证和可视化：
- Regex101.com：实时高亮各部分匹配逻辑，右侧自动解析捕获组、量词、断言，支持保存带注释的测试用例
- Super Expressive（JS）：用链式调用构建正则，生成的代码自带语义，几乎无需额外注释
- Pomsky：用接近自然语言的语法写模式，支持 // 注释，编译后输出标准正则
