Ctrl+Shift+H并非全局替换快捷键，而是用于在已打开且光标聚焦的搜索面板中展开替换栏；失效主因是搜索面板未开启或光标未在搜索框内。
Ctrl+Shift+H 是唯一可靠的全局替换快捷键，但必须满足两个前提：搜索面板已打开、光标聚焦在搜索框内。 直接按 Ctrl+Shift+H 却没反应？不是快捷键失效，而是你还没真正“进入”替换上下文。
Ctrl+Shift+H 为什么经常失灵
这个快捷键不是“一按就替换”，它本质是“在已激活的全局搜索面板中展开替换栏”。常见失效场景：
- 面板根本没打开——先按
Ctrl+Shift+F打开搜索面板 - 面板开着，但光标在编辑器里——点一下搜索框再按
Ctrl+Shift+H - 用了
Ctrl+H误以为能跨文件——它只作用于当前文件，且要求光标在编辑器中 - 右下角状态栏显示
Read-only——VSCode 默认跳过node_modules、.git等目录，这些文件不可写，也不会出现在可替换列表中
如何安全执行跨文件替换
盲目点“全部替换”容易破坏 JSON、YAML 或 HTML 结构。关键动作不是快，而是可控：
- 先输入搜索词，等结果完全加载后再展开替换栏（点右侧
→图标或按Alt+Enter） - 在“文件筛选”框里填
src/**/*.js或!**/*.test.js，把范围收窄到真实业务代码 - 启用正则（点
.*图标），用\boldFunctionName\b避免匹配到oldFunctionNameHelper这类子串 - 替换前手动点开 2–3 个匹配项，确认上下文是否合理；尤其注意字符串和注释里的误命中
- 不急着点“全部替换”，先点几个“替换”按钮验证效果，再决定是否批量操作
正则替换时捕获组怎么写才对
VSCode 的替换语法严格遵循 JavaScript 风格，$1 和 ${1} 不等价：
-
$1正确：匹配const (\w+) =后，替换为let $1 =能正确还原变量名 -
${1}错误：会被当作文本字面量，结果变成let ${1} = -
$10表示第 10 个捕获组，不是$1后跟数字0；不确定数量时优先用$&（整个匹配） - 命名捕获组更清晰：
(?<name>\w+)</name>→ 替换为$<name></name>，但需 VSCode 1.85+ 版本支持
最易被忽略的一点：VSCode 没有“替换预览”面板，所有替换操作一旦保存并关闭文件，就只能靠 Git 恢复。执行前务必确认工作区已提交干净，或至少用 Ctrl+Shift+G 扫一眼变更列表。
