Cmd+Shift+H是macOS上VSCode全局替换的唯一快捷键，打开面板后需先按Enter触发扫描，再执行Replace All，且修改后需手动保存。
Cmd+Shift+H 是 macOS 上全局替换的唯一快捷键
VSCode 在 macOS 上没有“替代方案”或“备用组合”，Cmd+Shift+H 是打开「在文件中替换」面板的硬编码快捷键，不可被其他命令覆盖（除非你手动重绑定它）。按下去后，面板默认聚焦在「查找」输入框，光标就位，可直接输入内容。如果没反应，请确认：当前焦点是否在编辑器区域（而非终端、调试控制台、设置页等非文本上下文）；是否误按了 Cmd+Shift+F（那是全局搜索，不带替换框）。
为什么 Cmd+Option+F 不是全局替换快捷键
Cmd+Option+F 是当前文件内的「查找并替换」，不是全局的。它和 Cmd+Shift+H 的根本区别在于作用域：Cmd+Option+F 只处理当前打开的 tab，哪怕你已打开 20 个文件，它也只改当前那个；而 Cmd+Shift+H 启动的是跨文件系统扫描，结果树会列出所有匹配的文件路径。很多人记混，是因为文档里把 Cmd+Option+F 写成“替换快捷键”，但没强调“单文件”这个前提——一旦想批量改 src/ 下所有 .ts 文件，就必须切到 Cmd+Shift+H。
全局替换前必须手动点「Find in Files」或按回车
Cmd+Shift+H 打开面板后，不能直接点「Replace All」。VSCode 不会自动扫描——它只对已加载的匹配项执行替换。所以必须先做一步：在「查找」框输完内容后，按 Enter 或点击右上角的「Find in Files」按钮。这时左侧才会出现文件列表，每个文件旁显示匹配数。漏掉这步，「Replace All」会静默失败，界面无提示，也没有报错信息。
- 按
Enter后若左侧为空，检查「files to exclude」是否还锁着node_modules、dist等目录 - 如果想限定范围，别靠记忆填路径，点「files to include」旁的
…→ 「Add pattern」，输入src/**/*.ts这类明确 glob - 正则启用后，
$1捕获组才有效；写\1或${1}都不会展开，而是原样输出
替换完成后不会自动保存，必须手动触发写入
VSCode 的「Replace All」只修改内存中的文档副本，不触碰磁盘。所有被改过的文件标签页左上角会出现圆点（●），表示“已修改未保存”。如果你关掉 VSCode 或切换分支前没保存，更改就丢了。安全做法是：
- 替换后全选所有变更标签页（
Cmd+Shift+P→ 输入 “Save All” → 回车） - 或提前开启自动保存：
Cmd+,→ 搜索files.autoSave→ 设为afterDelay - 更关键的是：别依赖「Replace All」一次清空所有问题——复杂重构建议先用
Cmd+Shift+F搜出全部位置，逐个点开确认上下文再手动替，尤其涉及注释、字符串字面量或正则边界时
真正容易翻车的不是快捷键记错，而是把「打开面板」当成「已经完成替换」。VSCode 的全局替换流程有三道显式闸门：启动面板 → 手动触发扫描 → 显式保存。跳过任意一环，结果都不可逆。
