VSCode原生支持多文件批量替换，无需插件；90%失败源于未确认“在文件中查找”模式、未关闭排除设置、未启用正则开关（.*图标+Regex标签）、误用Replace All（仅内存修改）而非Replace in Files（真正落盘），且捕获组必须用$1而非\1或${1}。
VSCode 自身就支持完整的多文件批量搜索替换，根本不需要插件——加插件反而容易引入兼容性问题、UI 冲突或额外权限请求。
为什么装了插件反而更难替换成功
很多用户装 multi-command、regex-replace 或 find-and-transform 后发现：正则不生效、跨文件没写入、替换后文件没保存。本质是这些插件绕过了 VSCode 原生的 Replace in Files 机制，自己实现文件读写逻辑，但没处理好只读文件、编码异常、未打开文件自动加载、Auto Save 时机等细节。
- 原生
Replace in Files（Ctrl+Shift+H）会真实打开每个命中文件、触发编辑器保存逻辑、尊重files.exclude和search.exclude配置 - 插件通常只做内存级字符串替换，再调用
fs.writeFileSync—— 一旦文件是 UTF-8 BOM、有 CRLF/LF 混用、或路径含中文，就可能写坏 - 插件无法感知你是否开了
Auto Save: afterDelay，常导致“替换了但没存”，你以为失败，其实是没触发保存
原生功能怎么用才真正生效
关键不是“能不能”，而是“有没有走对路径”。90% 的“没替换上”都卡在这几步：
- 确认顶部搜索框左侧显示的是 在文件中查找（不是灰色小字的“在当前文件中查找”），快捷键必须是
Ctrl+Shift+F或Ctrl+Shift+H - 点右上角
⋯→ 取消勾选 使用排除设置，否则**/node_modules/**这类规则会静默跳过目标目录 - 正则模式必须手动点亮
.*图标（或按Alt+R），且右下角出现 Regex 标签；替换时捕获组只认$1，写\1或${1}全部无效 - 真正落盘的操作是
Replace in Files（两个重叠文档图标），不是Replace All（它只改内存，标题栏 ● 圆点 ≠ 已保存）
什么情况下才真需要插件
只有当你要做原生功能完全做不到的事，才考虑插件，比如：
- 按 AST 结构替换（如只改函数调用，不碰字符串里的同名文本）→ 用
esbuild+ 自定义脚本，不是靠文本替换 - 跨项目联动替换（A 项目改了 API 名，自动同步更新 B 项目的 import 路径）→ 需要解析 import/export 关系，得用
typescriptSDK - 带条件判断的替换（如“只把第 3 行以后的 console.log 替成 debug”）→ 原生正则无法锚定行号，得写 Node.js 脚本遍历文件
这些都不是“搜索替换”问题，而是代码分析问题。硬塞进 VSCode 插件里，只会让逻辑更难调试、更难回滚。
