因为括号()是正则元字符，需转义为\(\)才能匹配字面括号；点号.也要转义为\.，否则匹配任意字符；启用正则后未转义会导致语法错误或不匹配。
为什么 console.log() 用正则搜不到
因为括号 ( 和 ) 在正则里是捕获组元字符，不转义就不是在找字面的括号，而是尝试开启/关闭分组——结果要么语法报错，要么完全不匹配。你输 console.log()，VS Code 默认当普通字符串处理；一旦开了正则模式（.* 图标点亮），它立刻按正则规则解析，() 就失效了。
必须写成：console\.log\(\) —— 点号、左括号、右括号全要加双反斜杠转义。
- 点号
.→\.（否则匹配任意字符） - 左括号
(→\( - 右括号
)→\) - 如果还要匹配里面的内容，比如
console.log("xxx")，就得写成console\.log\("[^"]*"\)
替换时括号内容怎么安全保留
靠捕获组 + 引用，而不是硬编码或猜结构。比如要把所有 console.log(...) 换成 debugger，但又想保留参数做日志迁移，就得先捕获参数再重用。
查找：console\.log\(([^)]*)\)
替换：debugger; // log: $1
-
([^)]*)表示“匹配除右括号外的任意字符”，比.*安全，不会跨到下一行或吞掉后续代码 -
$1是唯一有效的引用写法；\1或${1}在 VS Code 里静默失败 - 如果括号嵌套（比如
console.log(a(b))），这个正则会截断在第一个)，这是 VS Code 正则引擎限制，没法靠正则解决，得手动或换工具
带换行的括号块怎么匹配
默认情况下，. 不匹配换行符，所以 function foo\(\)\s*\{[\s\S]*?\} 这种写法在 VS Code 里可能只匹配单行。真正起作用的是显式用 [\s\S] 或 (.|\n)，但要注意性能。
- 安全写法：
function\s+\w+\s*\{[\s\S]*?\}（[\s\S]明确覆盖空格和换行） - 必须勾选搜索框下方的 ↵（“匹配换行符”），否则
[\s\S]也无效 - 避免无锚点开头，比如
[\s\S]*console\.log，大文件会卡死或触发 “Too many results” - 如果只是改 JSX 中的
className="..."这类属性，且值跨行，用className="[^"]*"不够，得换成className="[^"]*(?:\n[^"]*)*"
容易被忽略的坑：全局替换没反应
点了“全部替换”却没变化，大概率不是正则写错了，而是三个隐形开关没开对。
-
.*图标没点亮 → 右下角没显示Regex标签，所有元字符都当字面量 - 替换框为空 → VS Code 不报错，直接跳过，连提示都没有
- files to exclude 里有
node_modules（默认就有），但你想改的文件恰巧在里面 → 得清空该字段或改成!node_modules/**
最稳妥的验证方式：先按 Enter 触发“查找全部”，看左侧结果树是否列出你预期的项；再点任意一个 ▶ 展开上下文，确认前后几行逻辑一致——括号是否真在函数调用位置，而不是注释或字符串里。
