Ctrl+Shift+H（或Cmd+Shift+H）仅在搜索面板打开且聚焦时生效；files to include填.php或src//.php可精准匹配；正则替换用$1而非\1；Replace All后需手动Ctrl+Shift+S保存全部。
Ctrl+Shift+H 不起作用？先确认搜索面板已激活
全局替换快捷键 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）只在「搜索面板已打开且聚焦于搜索框」时才生效。如果面板没开，它不会自动唤起；如果光标在编辑器里，甚至可能触发其他命令。
常见错误现象：按下快捷键后无反应，或只在当前文件里搜——大概率是面板顶部显示灰色“文档”图标（即「在当前文件中查找」模式）。
- 稳妥做法：先按
Ctrl+Shift+F打开搜索面板 → 确认左上角图标是蓝色文件夹 → 再按Ctrl+Shift+H - 更直接的方式：按完
Ctrl+Shift+F后，直接点击搜索框右侧的 Replace 图标（或按Alt+Enter），替换框立刻展开 - Mac 用户注意：
Cmd+Alt+F可能被系统快捷键拦截（如截图），务必用Cmd+Shift+H
files to include 怎么填才能精准锁定 PHP 或 TS 文件
不设范围就点 Replace All，等于把 node_modules、dist、.git 全扫一遍——慢、干扰多、还可能误改依赖代码。
想只动 .php 文件，files to include 里填 *.php 最简明；但若项目结构深（比如 PHP 模板在 src/views/*.phtml），就得用通配符：
-
src/**/*.php→ 匹配src/下任意层级的.php文件 -
**/*.php,**/*.phtml→ 多类型用英文逗号分隔，注意无空格 - 填
.vscode/*.json比填.vscode更稳，避免路径解析歧义 - 排除目录别靠猜：想跳过
vendor，直接填vendor到files to exclude，不用加**/
正则替换写 $1 还是 \1？VSCode 只认前者
VSCode 用的是 JavaScript 正则引擎，捕获组引用必须写成 $1、$2。写 \1 或 ${1} 不报错，但会原样保留——你看到的“替换失败”，其实是静默当普通文本处理了。
典型翻车场景：想把 console.log("x") 改成 debugger; // x，正则写了 console\.log\(["'](.+?)["']\)，但替换字段填了 debugger; // \1。
- 正确写法：替换字段填
debugger; // $1 - 要字面输出
$abc，得写成$$abc（一个$转义另一个） - 非捕获组
(?:...)不占编号，别指望它生成$1 - 开启正则前，先关掉
.（跨行匹配）按钮——除非你真要匹配换行符，否则容易让.意外吞掉太多内容
Replace All 之后文件还是旧的？你漏了保存这步
Replace All 只改内存中的文件副本，不写磁盘。VSCode 不会自动保存，也不会弹窗提醒——改完一堆文件，右下角状态栏仍显示「未保存」，这就是信号。
尤其当工作区打开几十个标签页时，很容易只保存当前页，忘了其他被替换的文件。
- 最保险：替换完成后，立刻按
Ctrl+Shift+S（Windows/Linux）或Cmd+Shift+S（macOS）保存全部修改 - 如果某些文件是只读（比如 Git submodule 里的），右下角会显示 Read-only，替换按钮灰掉——得先解除只读，或用管理员权限重启 VSCode
- 替换前建议先
git add -p或提交一次，避免手抖点错Replace All后无法回退
