ctrl+shift+h仅在全局搜索面板已打开且焦点位于搜索框时生效；否则需先按ctrl+shift+f打开搜索，再点replace图标展开替换栏；限定目录须手动填写files to include（如src/components/*/.{ts,js}）；正则替换需启用regex、英文括号匹配且替换中用$1；replace all仅作用于已列出结果，且替换后需手动保存文件。
Ctrl+Shift+H 打开的是替换面板，不是搜索面板
很多人输完 Ctrl+Shift+H 没反应，是因为它只在「全局搜索面板已打开且焦点在搜索框」时才生效；如果面板没开，或光标在编辑器里，这个快捷键会失效甚至触发别的命令。更稳妥的路径是：Ctrl+Shift+F → 输入查找内容 → 点击搜索框右侧的 Replace 图标（或按 Alt+Enter）展开替换栏。
限定目录必须手动填 files to include，不能靠记忆
VSCode 不会自动识别“当前右键的文件夹”或“资源管理器中选中的目录”。想只改 src/components 下的文件，就得在替换面板下方的 files to include 输入框里明确写：src/components/**/*.ts 或 src/components/**/*.{ts,js}。常见错误包括：
- 留空该字段 → 默认扫整个工作区，可能误改
node_modules或dist - 只写
components→ 不匹配子目录，components/Button/index.ts就被漏掉 - 用错 glob 语法，比如写成
src\components\**\*.ts（反斜杠在 VSCode 里不认）
正则替换时 $1 生效的前提是括号存在且模式已启用
想把 class="old-btn" 批量改成 class="new-btn"，用正则 class="old-(\w+)" 替换为 class="new-" 是可行的，但必须满足三个条件：
-
.*按钮已点亮（启用正则），否则(\w+)当普通字符处理 - 括号是英文半角、成对出现，
(?:)这种非捕获组不生成$1 - 替换字段里写的是
$1，不是\1（后者会被当字面量）
另外，$ 在替换字段中是特殊字符，要输出字面量 $abc，得写成 $$abc。
全部替换前必须看到所有匹配项，否则操作无效
Replace All 按钮不会重新扫描文件，它只作用于当前面板里已列出的匹配结果。如果你没等匹配项加载完就点，或者过滤条件太宽导致卡住没显示全，就会漏改。实际建议：
- 先确认右上角
Match Case和Match Whole Word按钮状态是否符合预期 - 输入完
files to include后，稍等 1–2 秒，等左下角显示 “X results in Y files” - 遇到大量结果时，先缩小范围测试，比如先限定单个文件
src/components/Button.tsx，验证正则和替换逻辑无误再放开
最易被忽略的一点：替换完成后，VSCode 不自动保存文件。你得手动按 Ctrl+Shift+S 或逐个保存，否则 Git diff 里看不到变更。
