ctrl+h在搜索结果面板中有效需满足三条件：焦点在搜索结果区、正则模式已启用、替换后需手动保存；文件被排除或编码非utf-8会导致跨文件替换失败。
搜索结果面板里按 Ctrl+H 没反应？先确认是否在正确上下文
VSCode 的全局搜索替换不是“搜完再按 Ctrl+H”就能触发的，它只在搜索结果聚焦时才激活替换功能。常见错误是：执行 Ctrl+Shift+F 搜完后直接敲 Ctrl+H，但光标还在编辑器里——这时 Ctrl+H 触发的是当前文件的局部替换，和搜索结果无关。
实操建议：
- 用
Ctrl+Shift+F打开搜索面板，输入关键词并回车 - 确保搜索结果列表已展开且有高亮项（哪怕只有一条）
- 用鼠标点一下搜索结果区域，或按
Tab切入结果列表（焦点边框会变蓝） - 此时再按
Ctrl+H，才会出现“替换为”输入框，且顶部显示“在 32 个文件中替换”这类提示
替换后文件没保存？VSCode 默认不自动写入磁盘
即使你点了“全部替换”，VSCode 也只是把改动暂存在内存里，对应文件仍保持原状，直到你手动保存。这不是 bug，是设计上的安全机制——防止误操作污染源码。
实操建议：
- 替换完成后，检查左侧文件树里哪些文件名变成斜体 + 星号（如
index.ts*），说明已修改未保存 - 逐个右键点击文件 → 选“保存”，或全选文件（
Ctrl+A在文件树）后右键 → “全部保存” - 更省事：打开命令面板（
Ctrl+Shift+P），运行Files: Save All - 注意：如果启用了
"files.autoSave": "afterDelay"，延迟保存可能不覆盖搜索替换的变更，建议临时关掉
正则替换时 $1 不生效？捕获组必须用英文括号且不能嵌套
想把 user_id: 123 替成 userId: 123，写 user_id: (\d+) → userId: 却得到字面量 ，大概率是正则模式没开，或者括号用了中文全角。
实操建议：
- 先点搜索框右侧的
.*图标（启用正则模式），否则(\d+)会被当普通字符匹配 - 确保所有括号是英文半角：
(和)，不是（和） -
$1、$2只对应第一、第二对()，不支持命名捕获组（如(?<id>\d+)</id>） - 若需引用整个匹配，用
$&；想转义美元符本身，写$$
跨文件替换失败？检查文件是否被排除或编码不兼容
搜索能看见结果，但“全部替换”后某些文件没变化，常见原因是这些文件被 search.exclude 过滤了，或者用了非 UTF-8 编码（比如 GBK 的 .txt 文件）。
实操建议：
- 查看搜索面板右上角是否显示“已排除 X 个文件”，点旁边的齿轮图标检查
search.exclude配置 - 替换前，在搜索框下方勾选“使用排除设置”开关——关掉它才能强制包含被排除路径
- 对疑似编码异常的文件，先用 VSCode 手动打开它，右下角看编码标识（如
GBK），点击后选“通过编码重新打开” →UTF-8 - 注意：二进制文件（如
.png、.zip）默认不参与文本搜索替换，无需强行处理
真正卡住人的往往不是不会按快捷键，而是光标在哪、正则开了没、文件存没存、编码对不对——这些状态看不见，但每一步都决定替换是否落地。
