根本原因是VS Code默认子串匹配、不区分大小写且无单词边界，导致误替换；应开启Match Case、Match Whole Word和Use Regular Expression三个开关精准控制范围。
为什么全局替换总改错地方
根本原因不是正则写得不够 fancy，而是默认搜索行为太“宽”：不区分大小写、不认单词边界、不考虑上下文。比如搜 user，username、superuser、USER_ID 全中招；搜 log，console.log 和注释里的 // log this 一起被干掉。
VS Code 默认只做子串匹配，没有语义理解能力——它不知道你心里想的是变量名、函数调用还是字符串字面量。
- 关掉
Match Case时，Log和log都会被命中，但你可能只想动小写的调试调用 - 没开
Match Whole Word，id会匹配到user_id、identity、hidden - 没限定文件类型，
package.json里的"name"字段也可能被误替成"title"，直接破坏 JSON 结构
怎样用三个开关精准收窄匹配范围
真正起效的不是写多复杂的正则，而是先稳住这三个基础开关：
-
Match Case（Aa 图标）：对大小写敏感的命名规范（如 React 组件名首字母大写、hook 必须小写）必须打开 -
Match Whole Word（ab 图标）：改变量名或函数名时必开，避免handle替换掉handleError里的前缀 -
Use Regular Expression（.* 图标）：哪怕只是想加个单词边界或^行首锚点，也得开它；否则就是字面两个字符
例如把所有独立出现的 debug 改成 log，应搜 debug，而不是 debug —— 后者会在 debugger 里瞎切一刀。
如何安全地排除干扰文件和路径
很多“误替换”其实发生在你不关心的地方：node_modules、dist/、build/、甚至生成的 __tests__/mocks/。VS Code 不会自动跳过它们，除非你明说。
- 在搜索面板下方「files to exclude」框里填
node_modules, dist, build, **/*.min.js, **/coverage/** - 若只想改某模块，用「files to include」限定，如
src/features/auth/**, src/utils/** - 路径过滤支持 glob 语法，但注意：不加
**/前缀时，只匹配当前层，test/不会包含test/unit/ - 检查
settings.json中是否配置了files.exclude或search.exclude，它们会静默屏蔽文件，导致你搜不到、也替不了
多行替换和捕获组怎么防崩
想把多行 JSX 替成函数组件？或把 const x = 1; 批量转成 let x = 1;？不用正则捕获组，大概率格式错乱、缩进爆炸、括号失配。
- 多行匹配必须开
Use Regular Expression，换行符用( | ) - 用
()明确捕获你想保留的部分，替换时用$1、$2引用，别手写原文——复制粘贴容易漏空格或缩进 - 示例：把
const (\w+) = (.*?);→let $1 = $2;，比手动输let foo = 1;安全十倍 - 执行前务必勾选「Review changes」，预览右侧列出所有将改的文件和行；尤其注意是否波及
tsconfig.json、webpack.config.js这类结构敏感配置
最易被忽略的一点：VS Code 的「Replace All in Files」不会自动保存文件，改完还得手动 Ctrl+Shift+S。而如果你在预览里点了「Discard All」，所有已编辑但未保存的替换会直接丢弃——它不走 Git 暂存区，也不留撤回栈。
