必须用Ctrl+Shift+F（Windows/Linux）或Cmd+Shift+F（macOS）打开全局搜索面板，点击⋯→“Replace in Files”，输入内容后点“Replace All”才真正执行多文件替换；Ctrl+H仅作用于当前单文件。
VSCode 里全局替换不是靠快捷键“一键完成”，而是靠快捷键触发替换面板后，再手动确认范围和执行动作——直接狂按 Ctrl+H（Windows/Linux）或 Cmd+H（macOS）只能打开当前文件的替换面板，不等于批量生效。
怎么触发全局（多文件）替换？
必须先打开「查找」面板，再切换到「替换」视图，并明确指定搜索范围：
- 按
Ctrl+Shift+F（Windows/Linux）或Cmd+Shift+F（macOS）打开「全局搜索」面板（不是Ctrl+H） - 在搜索框输入要找的文本，在它右边点击
⋯按钮 → 选择「Replace in Files」，此时面板底部会出现替换输入框 - 输入替换内容，再点右上角
Replace All按钮（或按Ctrl+Alt+Enter/Cmd+Alt+Enter）才真正执行全局替换 - 注意：默认搜索范围是整个工作区；若只希望替换某几个文件，可在搜索框下方点击
files to include输入 glob 模式，例如**/*.js
为什么 Ctrl+H 不是全局替换？
Ctrl+H 是「当前编辑器内替换」的快捷键，它的作用域严格限定在当前打开的单个文件中。即使你开了十个 tab，它也不会跨文件生效——这是 VSCode 的明确设计，不是 bug。
- 常见误解：在多个文件里分别按
Ctrl+H→Replace All，看似“批量”，实则容易漏文件、无法统一预览、不能用正则跨文件匹配 - 真实需求中，多数人要的是“对 src/ 下所有 .ts 文件里的
console.log替成debugger”，这必须走Ctrl+Shift+F流程 - 如果你习惯用
Ctrl+H后误点Replace All，结果只改了当前文件，而你以为全改了，这就是最典型的踩坑点
替换时容易忽略的关键控制项
全局替换前，这几个开关状态直接影响结果，且默认不开启：
-
Match Case（大小写敏感）：勾选后API≠api，不勾选会一并替换，容易误伤 -
Match Whole Word（整词匹配）：避免把user替换成admin时，把username里的user也干掉 -
Use Regular Expression（正则模式）：启用后可写\bconsole\.log\b精准匹配，但写错正则会导致无结果或全崩；初学者建议先关着试 - 替换前务必点左上角
Find in Files预览匹配项——别跳过这步，否则Replace All是盲操作
全局替换没有“撤销所有文件更改”的快捷方式，一旦点错 Replace All，只能逐个文件按 Ctrl+Z 撤销，或者用 Git 恢复。所以每次执行前，花十秒看一眼预览列表，比事后补救快得多。
