VS Code全局替换需谨慎操作：先限定文件范围、慎用正则、善用捕获组、开启大小写/全字匹配，并替换后立即验证。
VS Code 的搜索与替换功能在批量处理大量文件时非常高效，但默认行为容易误操作——比如跨文件替换没确认范围、正则表达式写错导致全盘误改、或忽略大小写/文件类型限制引发意外覆盖。
全局搜索与替换前必须限定作用范围
直接按 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）打开全局替换面板后，别急着输内容。先检查右上角的三个关键过滤器：
-
files to include：填**/*.js或src/**，避免扫到node_modules或dist -
files to exclude：显式填**/test/**, **/*.d.ts，比靠 include 更稳妥 - 勾选
Use Regular Expression前确认是否真需要——很多“批量改变量名”其实只需普通字符串替换
用正则捕获组安全重写结构化内容
当要改的是带模式的文本（如把 console.log(x) 换成 debug(x)），必须用捕获组保留动态部分，否则会丢内容：
- 查找框填：
console\.log\((.+?)\)（注意点号转义、非贪婪匹配） - 替换框填：
debug($1)（$1对应第一个括号里的内容） - 不加
?会导致console.log(a); console.log(b)被当成一整段，只替一次 - 测试时先点
Find in Files看命中的行数和高亮是否合理，再点Replace All in Files
区分大小写与全字匹配影响替换精度
默认关闭的 Match Case 和 Match Whole Word 开关，对变量名/关键字类替换至关重要：
- 改
user为account时，不勾Match Whole Word会把username也改成accountname - 改
URL为Uri时，不勾Match Case会连小写的url一起动，破坏语义 - 这两个开关的位置在搜索框右侧，图标分别是
Aa和abc，不是默认开启的
替换后务必验证变更是否符合预期
VS Code 不提供替换预览 diff，所以操作后立刻检查三件事：
- 看底部状态栏提示的“Replaced X occurrences across Y files”，如果数字明显偏大（比如预期改 5 处结果报 200+），大概率范围或正则写错了
- 用
Ctrl+Shift+G打开源码管理视图，快速浏览变更文件列表，确认没波及不该动的目录 - 挑 2–3 个典型文件，手动展开修改行，重点看上下文是否被连带破坏（比如注释里误替、字符串内误替）
真正麻烦的不是替换动作本身，而是正则边界没控好、或排除路径漏写一个星号——这种错误往往要等运行时报错才暴露。
