Ctrl+Shift+H（Win/Linux）或Cmd+Shift+H（macOS）是VSCode中唯一真正生效的全局替换快捷键，直接唤起“在文件中替换”面板，支持跨文件写入磁盘；其他组合键如Ctrl+H仅限当前文件，Ctrl+Shift+F需手动展开替换框，效率低且易漏。
Ctrl+Shift+H 是真正生效的全局替换快捷键
按 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）直接唤起“在文件中替换”面板——这是唯一能跨文件写入磁盘的操作入口。很多人误用 Ctrl+H，它只作用于当前打开的文件；而 Ctrl+Shift+F 打开的是搜索面板，不带替换框，必须手动点“替换”图标才展开，效率低且易漏。
常见错误现象：快捷键按了没反应、搜到了却点不了“全部替换”。本质是没进入“在文件中替换”模式——确认左上角搜索区域显示“在文件中查找”，而不是灰色小字“在当前文件中查找”。
替换前必须检查 search.exclude 和 files to exclude
VSCode 默认跳过 node_modules、.git、dist 等目录，靠的是 search.exclude 配置项。它不区分你是否真想改，只要路径匹配就静默跳过。
- 检查方式：按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)→ 查看是否有search.exclude或files.exclude条目 - 临时绕过：搜索面板右上角点击
⋯→ 取消勾选“使用排除设置”（仅本次生效） - 路径陷阱：
**/api/**会排除所有含api的子目录（如src/utils/apiClient），应写成src/api/**才精准
正则替换必须点亮 .* 开关并用 $1 引用捕获组
未启用正则时，\d+、^、$ 全部当普通字符处理，搜不到就是开关没开。右下角出现 Regex 标签才算真正生效。
- 最稳开启方式：按
Alt+R（Win/Linux）或Cmd+Option+R（macOS），一次切换，全程保持 - 替换字段里写
$1，不是\1或${1}；$&表示整个匹配内容，$$才输出字面量$ - 跨行匹配需显式写
[sS]*或(.|\n)*，默认的.不匹配换行符
Replace All 和 Replace in Files 是两回事
面板里点“全部替换”按钮，只是把结果存在内存里；文件标题栏出现 ● 圆点 ≠ 已保存。真正落盘的是“替换在文件中”（两个重叠文档图标），它会逐个打开命中文件、执行替换、触发保存逻辑。
- 未打开的文件：会被
Replace in Files自动加载并修改；但Replace All完全触达不到 - 只读文件：右下角显示
Read-only时，Replace in Files会跳过，需先解除只读或用管理员权限运行 VSCode - 自动保存不能替代确认：
Auto Save（afterDelay）可防漏存，但无法挽回误替换
真正难的不是怎么按快捷键，而是确认每个匹配项上下文是否合理——比如 console.log 出现在注释里、JSX 属性值跨多行、CSV 中引号包裹的字段被连带修改。这些必须点开 ▶ 展开预览，逐个核对。
