VS Code 怎么用正则批量替换并保留捕获内容

把一批 user_name 改成 userName，并不需要逐行编辑。VS Code 的正则替换可以先用圆括号捕获想保留的部分，再在替换框中按 $1、$2 取回它们。真正容易出错的地方，是一上来就在整个工作区点“全部替换”，或把捕获组的顺序写反。

先把替换范围收窄到能确认的文件

只改当前打开的文件时，按 Ctrl/Cmd+H；要跨文件处理时，按 Ctrl/Cmd+Shift+H 打开搜索视图，再展开 Replace 输入框。官方文档说明，工作区替换会按文件显示命中位置，并能逐项、单文件或全部应用变更。第一次改规则时，建议只在一个文件里完成一轮，确认结果后再扩到工作区。

开启正则并用括号定义要保留的内容

点击查找框右侧的 .*，再输入查找式。假设有如下配置：

user_name: "alice"
order_name: "book"

要改成驼峰字段名，同时保留冒号后的值，可查找：

([a-z]+)_([a-z]+)(:\s*.*)

三个括号分别捕获字段前半段、后半段和冒号后的原内容。替换框写成：

$1$2$3

结果会是 username: "alice"。如果你希望第二段首字母大写，可在替换框写 $1\u$2$3，得到 userName: "alice"。VS Code 官方文档明确规定，替换字符串里的捕获组按 $n 引用；也支持 \u、\l、\U、\L 调整捕获组字母大小写。

替换框里的 $1、$2 到底对应什么

编号只看左括号出现的顺序，不看你觉得哪段更重要。需要原样保留的一段必须放进括号；没有被捕获的部分不会自动带入替换结果。正则里仅用于分组、却不需要编号时，可以使用 (?:...)，这样后面的编号不会被它占用。

先看差异，再从单处替换扩大到全部

输入替换内容后，VS Code 会显示待应用的差异。先用单项 Replace 查看一两条：字段名是否正确、值前面的冒号与空格是否还在、是否误匹配了注释或不该处理的文件。跨文件时尤其要填写 include/exclude 范围，例如只处理 src/**/*.json，避开构建产物和依赖目录。

容易踩的三个坑

• 忘记开启正则：查找框会把括号和 + 当普通字符，命中数通常为零。
• 把 $1 写成 \1：替换框应使用 $n 引用捕获组。
• 捕获范围太贪心：先避免随手写 .* 吞掉整行；能用具体字符类或非贪心条件时，预览会更可靠。

常见问题

能只在选中文本中替换吗？

可以。选中多行后打开查找，使用 Find in Selection 选项即可把范围限制在选区内。

替换错了怎么恢复？

尚未保存时可直接撤销；已替换很多处时，优先用版本控制或保存前的变更视图确认，不要继续叠加第二轮替换。

为什么工作区替换没有搜到文件？

确认打开的是文件夹或工作区，并检查 include/exclude 条件、搜索排除设置与 .gitignore 的影响。