ctrl+shift+h（win/linux）或cmd+shift+h（macos）是vscode全局替换的默认快捷键，直接打开多文件替换视图，需手动执行find all后才能使用replace all，且应配合files to include/exclude限定范围以防误改。

Ctrl+Shift+H 是全局替换的默认快捷键

VSCode 中执行跨文件批量替换，Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）是唯一默认启用的全局替换入口。它不等价于 Ctrl+Shift+F（仅搜索不替换），也不等价于 Ctrl+H（只作用于当前文件）。按下后直接打开多文件替换视图，光标默认聚焦在“查找”输入框。

为什么按了没反应？常见卡点

不是快捷键失效，而是触发条件没满足：

• 光标不在编辑器主区域（比如正停留在终端、调试控制台、输出面板里）→ 快捷键被该面板拦截
• 工作区未打开（即只是单独打开一个文件，没通过 File → Open Folder 加载整个目录）→ Ctrl+Shift+H 会静默失败，不报错也不弹窗
• 当前是只读文件（如 node_modules 下的文件）→ 替换面板能打开，但“Replace All”按钮置灰
• 系统级快捷键冲突（尤其 macOS 上某些输入法或录屏工具会劫持 Cmd+Shift+H）→ 可在 Settings → Keyboard Shortcuts 中搜 workbench.action.findInFiles 确认绑定是否被覆盖

替换前必须手动点 Find All，否则 Replace All 不生效

Replace All 按钮只对已扫描出的匹配项起作用，它不会实时重新搜索。这是最常被忽略的机制：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 输完查找内容后，必须主动点击右上角的 Find All（或按 Enter），才能生成左侧文件树里的匹配列表
• 如果跳过这步直接点 Replace All，VSCode 会提示 “No results found”，哪怕文本确实存在
• 修改查找内容后，需再次点 Find All 刷新结果；编辑器不会自动同步更新匹配集

files to include 是防止误伤的关键开关

默认情况下，Ctrl+Shift+H 会扫描整个工作区，包括 node_modules、dist、.git 等目录。实际使用中几乎总是要限制范围：

• 点击搜索框下方的 files to include 输入框旁的 … 图标 → 选 Add pattern
• 填入 src/**/*.ts 比填 *.ts 更安全，避免扫到配置文件或测试用例
• 想排除某类路径？在 files to exclude 里填 **/test/** 或 **/*.spec.ts
• 正则开启时（.* 按钮变蓝），files to include 仍只支持 glob 模式，不支持正则语法

真正麻烦的不是记不住快捷键，而是每次替换前都得检查范围、确认 Find All 已执行、留意正则捕获组编号是否错位——这些细节不显眼，但一漏就可能改错几十个文件。