VSCode全局替换需五步闭环：打开面板、确认范围、激活替换、执行替换、手动保存。跳过任一环节改动仅存内存，Git不可见，文件未真实修改。
VSCode 全局替换不是按一次快捷键就完事，必须分步触发、手动确认范围、再显式执行写入——跳过任一环节，替换就只停留在内存里，Git 看不到改动，文件也没真改。
Ctrl+Shift+H 打开的是“替换面板”，不是“自动替换”
很多人按了 Ctrl+Shift+H（Win/Linux）或 Cmd+Shift+H（macOS）后直接输内容点“全部替换”，结果没生效。这是因为：
- 这个快捷键只打开面板，不自动聚焦到替换输入框；必须先点一下搜索框，再点右侧的 Replace 图标（或按
Alt+Enter），下方替换栏才真正激活 - 面板右上角若显示灰色“文档”图标，说明它卡在“当前文件”模式，得再按一次
Ctrl+Shift+H或手动勾选「在文件中查找」 - 如果光标在终端、调试控制台或设置页，快捷键会失效——确保编辑器区域有焦点
files to include 必须手动填，否则默认扫整个工作区
不设过滤，Ctrl+Shift+H 会递归扫描所有子目录，包括 node_modules、dist、.git，轻则卡顿，重则误改依赖包。
- 想只改
.ts文件：在files to include输入*.ts；想限src下：填src/**/*.ts - 排除干扰目录：在
files to exclude填node_modules, dist, build - Mac 用户注意：
Cmd+Alt+F是系统级快捷键（Spotlight），常被拦截，务必用Cmd+Shift+H
正则替换时 $1 生效的前提是 .* 按钮已点亮且括号编号正确
查 import\s+(\w+)\s+from\s+['"](.+?)['"]，想替成 import $1 from "$2"，但结果原样不动？问题通常出在这几处：
-
.*图标没点蓝——正则模式未启用，所有括号都当普通字符处理 - 写了
\1或\2：VSCode 只认$1、$2，\1会被当字面量输出 - 用了
(?:...)非捕获组：它不占编号，$1指向的是第一个(...)，不是第几个括号视觉上排第几 - 要字面输出
$abc，得写成$$abc；否则$a被当成未定义捕获组，静默忽略
Replace All 不保存，必须 Ctrl+S 写入磁盘
点完“全部替换”，标题栏出现 ● 圆点 ≠ 已落盘。VSCode 的替换操作只修改编辑器内存缓冲区，不触碰文件系统。
- 没保存前，Git status 看不到任何变更，
git diff为空 - 有些文件可能根本没在编辑器里打开过，
Replace All对它们完全无效——只改已加载进内存的副本 - 建议开启
File > Auto Save并设为afterDelay，或替换后立刻按Ctrl+Shift+S保存全部 - 更稳妥的做法：替换前先
git add -A && git commit -m "pre-replace backup"
最常被忽略的一点：全局替换不是“搜完就换”，而是“搜 → 预览 → 确认范围 → 显式替换 → 显式保存”五步闭环；少走一步，改动就悬在半空。
