ctrl+shift+h（windows/linux）或 cmd+shift+h（macos）是vscode中唯一直达跨文件替换界面的全局快捷键，提供查找与替换双输入框，区别于仅限当前文件的ctrl+h；需手动设置包含/排除文件模式（如/.ts、!/test/）并启用.才能正确执行正则替换。
Ctrl+Shift+H 是唯一真正全局的替换入口
VSCode 里没有“后台自动替换”，所有跨文件操作都必须手动触发，而 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）是唯一直达「在文件中替换」视图的快捷键。它不是搜索面板，而是带查找+替换双输入框的专用界面。误用 Ctrl+H 只会锁死在当前文件，哪怕你开了 20 个 tab 也毫无影响。
常见错误现象：Ctrl+H → 输词 → 点「全部替换」→ 其他文件完全没变。这不是 VSCode 坏了，是你根本没进对门。
使用场景：
- 重构 TypeScript 接口名，需同步改
src/**/*.ts和types/*.d.ts - 清理 CSS 中已废弃的类名，限定
**/*.css但排除legacy.css - 批量修正日志语句，如把
console.log换成logger.debug
范围不设等于白干：包含/排除文件必须手动填
默认情况下 Ctrl+Shift+H 扫整个工作区，但 VSCode 的 search.exclude 配置只是“默认不显示”，并非真正跳过——如果你没填「包含文件」，它仍可能扫到 node_modules 或 dist，尤其当这些目录被显式加入工作区时。
参数差异：
-
*.ts：匹配项目根目录下所有 .ts 文件（不含子目录） -
**/*.ts：递归匹配任意层级的 .ts 文件 -
src/**/api/*.ts：精准定位 API 相关类型文件 -
!**/test/**或!*.spec.ts：在「排除文件」栏填写，避免误改测试代码
容易踩的坑：只填了搜索词和替换词，却忘了点「包含文件」框右侧的 … 图标添加 pattern，结果搜了一分钟，全是 node_modules 里的干扰项。
正则替换必须亲手点亮 .*，且捕获组只认 $1
VSCode 用的是 ECMAScript 正则引擎，不支持 \K、(? 等 PCRE 特性，但基础功能完全够用——前提是你要主动启用它。点一下右上角的 <code>.* 图标（或按 Alt+R / Cmd+R），图标变蓝且右下角出现 Regex 标签才算生效。
性能 / 兼容性影响：
- 未启用
.*时，\d+会被当字面量搜索，搜不到任何数字 - 写了
console\.log$$([^)]+)$$却替换失败？大概率是.*没开，或括号用了中文全角 - 替换字段里写
\1不生效，必须写$1；要输出字面量$abc，得写成$$abc - 贪婪匹配易出错，比如
".*"会吞掉整行引号内容，改用"[^"]*"更稳
Replace All 不等于保存，Git 看不到改动就是没落盘
VSCode 的 Replace All 按钮只修改编辑器内存中的副本，不会自动写入磁盘。标题栏出现 ● 圆点 ≠ 已保存，必须手动按 Ctrl+S（或开启 File > Auto Save 并设为 afterDelay）才能让 Git 检测到变更。
更隐蔽的问题：
- 没打开过的文件（比如
src/utils/xxx.ts从未在编辑器中 tab 过），Replace All对它们完全无效——VSCode 不会加载未打开的文件进内存 - 某些路径含空格或特殊字符时，glob 模式可能失效，建议先用
Ctrl+Shift+F搜一遍确认能命中 - 替换后立刻运行
git status，如果没看到改动，八成是漏了Ctrl+S
真正难的从来不是怎么按快捷键，而是每次替换前，是否真的看清了预览列表里的每一个路径和上下文。一个 config.API_URL 和一个 user.api_url 同时出现在结果里，你敢一起换吗？
