VSCode全局替换必须前置控制范围、启用正则并预检结果，否则极易误改；需点击漏斗图标限定files to include/exclude，勾选Aa/ab，点亮.*按钮用$1捕获组，每次替换前手动Find All确认匹配项。
VSCode全局替换不是“输完就按全部替换”就能安全落地的操作，它默认扫描整个工作区，不加限制极易误改 node_modules、dist、测试文件或配置项——真正安全的替换，靠的是范围前置控制和正则逻辑校验，而不是事后靠 Git 撤回。
Ctrl+Shift+H 打开的是「范围未设」的危险面板
这个快捷键（Cmd+Shift+H on macOS）直接弹出替换视图，但它的默认行为是“搜整个工作区”，包括所有子目录和隐藏文件。你没点漏斗图标、没填 files to include，它就真会去扫 package-lock.json 甚至 .git/config。
- 首次打开后，务必先点右上角漏斗图标 → 「Add pattern」→ 填
src/**/*.ts或**/*.vue，而不是依赖记忆里“应该只在源码里换” - 如果项目含生成代码（如
api/下的 auto-generated.ts），直接加!api/**到files to exclude，别等替换完发现接口调用全崩了 - 勾选
Aa（区分大小写）和ab（全字匹配）不是可选项——比如把user替成profile，不勾ab会把username也干掉
正则替换时 $1 生效的前提是括号编号对且 .* 按钮已点亮
VSCode 的正则替换不认 ，只认 ；捕获组编号从左到右严格递增，(?:...) 不占号，但很多人写 (\w+)(?:\s+from) 还指望 能取到 from 后面的内容，结果全是空。
- 搜索字段写
import\s+(\w+)\s+from\s+['"](.+?)['"]，替换填import $1 from "$2"才有效；填import \1 from "$2"就是白忙活 -
.*按钮必须点亮（变蓝），否则.不代表任意字符，\s也不匹配换行符——多行替换失败，八成是这儿没开 - 想字面输出
$abc？得写成$$abc，否则 VSCode 当成未定义捕获组静默忽略
Replace All 不扫描新内容，只作用于当前高亮结果
这是最常被忽略的机制：VSCode 不会在你改完第一处后自动刷新剩余匹配项。如果你删了某行导致上下文变化，后续原本能匹配的项可能失效，但面板不会告诉你——它只替你“Find All”那一刻看到的那些。
- 每次修改前，先手动点「Find All」（放大镜图标），确认列表里全是你要动的项；别信初始预览
- 改完一批后，哪怕只是小范围，也建议再点一次「Find All」，看是否还有残留——尤其涉及缩进、注释或模板字符串换行的场景
- 批量替换后，别急着保存，先用
Ctrl+K S（Cmd+K S）保存所有，再立刻开 Git 资源管理器看 Diff，重点盯console.log、require、路径字符串这类易断裂位置
真正卡住人的从来不是“怎么打开替换面板”，而是“怎么让 VSCode 知道你只想动哪几行、在哪几类文件里、按什么结构动”。范围、正则、预检，三者缺一不可；少做一步，就多一分靠 Git revert 救火的概率。
