Ctrl+Shift+H仅打开“替换在文件中”面板并聚焦查找框，不自动执行替换；必须手动输入内容、点击放大镜（或回车）触发搜索，待显示“共X处匹配”后，Replace All才生效，且需保存（Ctrl+S）才能写入磁盘。
Ctrl+Shift+H 不是“直接替换”，而是“打开替换面板”
很多人按了 Ctrl+Shift+H 没反应，或点了 Replace All 却没改任何文件——根本原因在于误以为这个快捷键会自动执行替换。它只做一件事：打开「替换在文件中」面板，并把焦点放在查找框。后续所有操作（输入内容、启用正则、限定范围）都得手动完成。
常见卡点：
- 面板弹出但光标不在查找框 → 快捷键失效，需手动点一下查找框再输内容
- 按完
Ctrl+Shift+H立刻回车 → VSCode 会用空搜索触发一次“找空字符串”，结果扫遍整个工作区却无意义 - Mac 上
Cmd+Shift+H被系统快捷键拦截（如截图工具），可临时关掉系统设置里的冲突项
全局替换前必须手动点“查找全部”，否则 Replace All 无效
Replace All 按钮不实时扫描，它只作用于当前已高亮的匹配项列表。如果你跳过“查找全部”这步，面板下方没有显示任何匹配结果，Replace All 就是灰色的，或者点了也什么都不会发生。
实操要点：
- 输完查找内容后，必须点搜索框右侧的放大镜图标（或按
Enter），等右下角出现「共 X 处匹配」才表示加载完成 - 大项目首次搜索有延迟，右下角显示「搜索中…」时别急着点 Replace All
- 没打开过的文件不会被加载进编辑器内存，
Replace All对它们完全不起作用——这点和 IDE 的“后台索引替换”有本质区别
正则替换里 $1 和 \1 完全不是一回事
VSCode 用的是 JavaScript 正则引擎，捕获组引用只认 、、$&。写 或 都会被当普通文本处理，界面不报错，也不警告，只是静默失败。
容易翻车的场景：
- 查
class="([^"]+)"，想替换成class="$1 is-primary"，却填成class="\1 is-primary"→ 结果变成字面量\1 - 要输出字面量
$abc，得写成$$abc；写$abc会被截断为$+abc，其中$无效，abc原样保留 - 括号必须英文半角、严格配对；
(?:)是非捕获组，不占编号，别指望它生成$1
替换后没进 Git？你根本没保存
Replace All 只修改编辑器内存中的文档副本，不写入磁盘。标题栏出现 ● 圆点 ≠ 已保存，只是“有未保存更改”。Git 看不到改动，是因为文件系统里还是旧内容。
关键动作只有两个：
- 替换完成后，必须手动按
Ctrl+S（Windows/Linux）或Cmd+S（macOS） - 如果改了多个文件，
Ctrl+Shift+S（全部保存）比逐个Ctrl+S更可靠
更隐蔽的问题：有些文件是只读状态（比如被其他进程锁定），右下角显示 Read-only，这时替换按钮会灰掉，必须解除只读或用管理员权限重启 VSCode。
