ctrl+shift+h（windows/linux）或 cmd+shift+h（macos）是vscode全局替换的真正入口，触发“在文件中替换”视图；replace in files才真正写入磁盘，replace all仅内存修改；search.exclude静默过滤路径，正则替换须用$1而非\1。
Ctrl+Shift+H 和 Cmd+Shift+H 是全局替换的真正入口
很多人误以为 Ctrl+H 或 Cmd+Option+F 能跨文件替换，其实它们只作用于当前打开的文件。真正触发多文件替换的快捷键是 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）。按下去后，VSCode 会直接打开「在文件中替换」视图，而不是「在当前文件中替换」——这是区分是否全局生效的第一道门槛。
常见错误现象：输完内容点「全部替换」没反应，或只改了当前文件。原因往往是快捷键按错，或者面板左上角显示的是「在当前文件中查找」（灰色小字），而非「在文件中查找」（蓝色高亮）。遇到这种情况，别重开面板，直接按 Ctrl+Shift+H 强制唤起正确模式。
Replace All 不写入磁盘，Replace in Files 才真改文件
点击「全部替换」按钮（两个重叠文档图标）只是把匹配项在内存里批量修改，文件标题栏出现 ● 圆点 ≠ 已保存。真正落盘的操作是 Replace in Files —— 它会逐个打开命中文件、执行替换、触发保存逻辑，连你之前没打开过的文件也会被加载并修改。
- 如果某文件是只读状态（右下角显示 Read-only），
Replace in Files会跳过，不会报错提示 -
Replace All对未打开的文件完全无效，哪怕它在搜索结果列表里显示出来了 - 启用
Auto Save（File > Auto Save）能减少漏存，但不能替代手动确认Replace in Files
search.exclude 会静默过滤，不检查就等于盲换
VSCode 默认通过 search.exclude 排除 **/node_modules/**、**/.git/**、**/dist/** 等路径，但它不跟你商量——哪怕你正要修 node_modules 里的 patch 文件，只要路径匹配，就跳过。
检查方式：Ctrl+Shift+P → 输入 Preferences: Open Workspace Settings (JSON) → 查看是否有 search.exclude 条目。临时绕过方法：在搜索面板右上角点击 ⋯ → 取消勾选「使用排除设置」（仅本次生效）。
路径通配符陷阱：**/api/** 会排除所有含 api 的子目录（如 src/utils/apiClient），而 src/api/** 才只排除顶层 src/api 目录。
正则替换必须用 $1，\1 是无效的
VSCode 使用 JavaScript 正则引擎，捕获组引用必须写成 $1、$2，不是 \1。比如想把 console.log("x") 换成 debugger; // x，正则写 console\.log\(["'](.+?)["']\)，替换字段就得填 debugger; // $1；填 debugger; // \1 就会原样输出 \1。
其他关键细节：
-
.*按钮点亮才启用正则，但旁边的.（跨行匹配）按钮默认关闭，除非你真需要匹配换行符，否则别点 -
(?:)是非捕获组，不占编号，别指望它生成$1 - 要字面输出
$abc，得写成$$abc，因为$在替换字段中是特殊字符
最易被忽略的点：全局替换前必须手动点「查找全部」，否则 Replace in Files 只处理已缓存的匹配项；而「查找全部」本身不会自动展开所有文件，它只刷新面板里的预览列表——你得亲眼看过每一条，才能确认正则没误伤。
