ai能看懂的注释需结构化：明确边界、格式、例外，用具体示例代替模糊描述，注明使用场景（如vscode搜索不支持命名捕获），并区分正则字面量与字符串转义形式。
VSCode里写什么注释，AI才真能看懂你要的正则
AI不是读心术，它依赖你注释里的结构化线索。光写“匹配邮箱”没用，得说清边界、允许格式、排除例外。vscode 本身不解析注释，但 Copilot、Continue、CodeWhisperer 这类插件会把光标附近的注释+上下文一起喂给模型——所以注释得像给同事写需求，不是写日记。
实操建议：
- 用
// TODO: match phone number in CN format, 11 digits, start with 1, no separator比// 匹配手机号有效十倍 - 显式写出「要什么」和「不要什么」：
// ✅ "2024-03-15" → true; ❌ "2024/03/15" or "15-03-2024" - 避免模糊词：删掉“大概”“可能”“类似”，换成具体字符串示例（哪怕只写一个）
- 如果目标是提取字段，直接写预期输出：
// extract: {year: "2024", month: "03", day: "15"}
Copilot 生成正则后，为什么一粘就报错 Invalid regular expression: /.../: Nothing to repeat
这是最常踩的坑：AI生成的正则默认是 JavaScript 字符串字面量，但你直接塞进 new RegExp() 或字面量 /.../ 时，反斜杠没转义就炸了。比如它给你 \d{4}-\d{2}-\d{2}，你复制成 /d{4}-d{2}-d{2}/，第一个 就被 JS 当成转义符吃掉了。
实操建议：
- 生成结果里看到双反斜杠
\，说明是字符串形式；看到单反斜杠，说明是字面量形式——先看清再动 - 在 JS 中优先用字面量：
/d{4}-d{2}-d{2}/，那就要求 AI 输出时别带多余\ - 如果必须用
new RegExp(str)，让 AI 明确加一句“输出为 JS 字符串，已双转义”，或自己把d手动改成\d - 测试前先丢进 regex101.com，选 JS 引擎，粘进去立刻看语法是否高亮——不亮就是格式错了
为什么 AI 生成的正则在 VSCode 查找框里不生效
VSCode 内置查找（Ctrl+F）用的是 PCRE 衍生语法，不支持 JS 特有特性，比如 ?<name></name> 命名捕获组、k<name></name> 反向引用、/(?=...)/ 后行断言（Lookbehind）在旧版里也不全支持。
实操建议：
- 在注释里明确写上使用场景：
// for VSCode search bar, no lookbehind, no named groups - 避开
(? 和 <code>(?<...> —— 改用 <code>(?=[^\n]*$)类替代逻辑，或接受局限性 - VSCode 查找默认不开启“正则模式”，记得点那个
.*图标，否则你写的\d+就当普通字符串搜 - 想全局替换？注释里补一句：
// replace all numbers with "[NUM]"，AI 才会给你带$1的替换字符串
复杂正则需要分步验证，但 AI 一次给不完怎么办
别指望 AI 一步写出带 5 层嵌套、兼顾 Unicode 和边界条件的正则。它擅长拆解，但需要你引导。比如你要匹配“带单位的数字”，AI 可能漏掉 1.5e3kg 或 −273.15°C，但如果你分两轮提需求，效果好得多。
实操建议：
- 第一轮注释聚焦主干：
// match number with optional sign and decimal, e.g. "-123.45" - 第二轮追加约束：
// extend to support scientific notation like "1.23e-4", and allow units: "kg", "°C", "px" - 把 AI 给的中间版本粘进
console.log(RegExp(...).test(...))快速试几个用例，错在哪就补哪条注释再问 - 对特别长的正则，用
RegExp构造函数 + 多行字符串更可控：new RegExp(`\d+(?:\.\d+)?(?:e[+-]\d+)?\s*(?:kg|°C|px)`, 'i')
真正卡住的往往不是正则本身，而是你没告诉 AI：你要在哪儿用、谁来维护、要不要兼容 IE、有没有性能敏感。这些细节不写进注释，AI 就只能猜。
