ctrl+shift+h本身不直接打开替换功能，仅在全局搜索面板（ctrl+shift+f）已激活且光标聚焦于替换框时生效；若未展开替换栏、文件不支持替换、search.exclude误过滤目录、正则引用错误（如用\1而非$1）或未限定替换范围，均会导致静默失效。
Ctrl+Shift+H 按了没反应？先确认搜索面板已就绪
不是快捷键坏了，是 Ctrl+Shift+H 本身不负责“打开替换”，它只在全局搜索面板（Ctrl+Shift+F 打开的）已激活且光标聚焦于替换框时才起作用。常见误操作：输完搜索词直接按 Ctrl+Shift+H，但此时面板还没展开替换栏。
- 必须先按
Ctrl+Shift+F→ 输入关键词 → 按Enter或点放大镜图标完成搜索 - 再点击搜索框右侧的 Replace 图标（或按
Alt+Enter），让替换输入框出现 - 此时光标应落在替换框内；若没自动聚焦，手动点一下再按
Ctrl+Shift+H - 临时预览文件（如 Git diff 中打开的未保存副本）不支持替换，会静默失败
替换了却有文件没变？检查 search.exclude 是否误拦
search.exclude 是决定哪些目录参与全局搜索的唯一配置项，和 files.exclude 无关。写错一条 glob 模式（比如漏掉 **/），就可能把本该修改的 src/api/ 或 config/ 目录一起过滤掉——而且 VSCode 不报错、不提示，只是跳过。
- 打开命令面板（
Ctrl+Shift+P）→ 输入Preferences: Open Settings (JSON) - 检查是否有
"search.exclude"条目，特别注意是否包含类似"**/utils/**"这种宽泛规则 - 临时绕过：在搜索面板右上角点击齿轮图标 → 取消勾选「使用排除设置」（仅本次生效）
- 想彻底禁用 .gitignore 干扰？加配置
"search.useIgnoreFiles": false
正则替换后内容不对？小心 $1 和 \1 混用
VSCode 用的是 JavaScript 正则引擎，捕获组引用只认 $1、$2，写 \1 或 $$1 都会静默失效——界面不报错，但替换结果就是原样保留，极易误判为“没生效”。
- 查
class="([^"]+)"，替换填class="$1 is-primary"✅；写成class="\1 is-primary"❌ - 要输出字面量
$1，必须写成$$1；单个$会被当成未定义捕获组直接丢弃 -
$1后紧接数字（如$10）会被解释为第 10 组；需写成${1}0才表示“第 1 组内容 + 字符 0” - VSCode 不支持
$&以外的特殊引用（如$`、$'），也不支持\K等 PCRE 特性
改完发现 JSON 缩进乱了或引号没了？替换前没限定范围
全局替换对结构化文件（JSON/YAML/HTML）极不友好。一次 user → currentUser 可能误改注释、字符串值、甚至 key 名本身，而 VSCode 没有“替换预览”面板，只能靠人工拦截。
- 执行替换前，先点搜索面板底部的文件夹图标，把范围限定到
src/或packages/等明确目录 - 逐个点击左侧匹配的文件名，展开上下文，确认高亮行是否真属于目标语义（比如搜
id，得避开user_id或// id for tracking） - 替换完别急着
Ctrl+S，先按Ctrl+Shift+G打开源码管理视图，重点检查 JSON/YAML 文件的缩进、引号、逗号是否被破坏 - 对敏感文件（如
package.json、tsconfig.json），建议先用Ctrl+Shift+P→Git: Diff Active File看修改前后差异
when 条件拼错、search.exclude 规则太宽、正则里用了 \1，VSCode 全部静默处理，只留你对着没变化的文件发呆。
