ctrl+shift+h（windows/linux）或 cmd+shift+h（macos）才是全局替换的真正入口，需在已打开的全局搜索面板中且光标聚焦搜索框时生效；它不自动保存、不处理未打开文件、正则替换需同时启用正则模式、含捕获组、使用$1语法。
Ctrl+Shift+H 是全局替换的真正入口，不是 Ctrl+Shift+F
很多人误以为 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS）能直接替换——它只能搜索。真正触发「替换」行为的是 Ctrl+Shift+H 或 Cmd+Shift+H，这个快捷键必须在全局搜索面板已打开、且光标聚焦于搜索框时才生效。如果面板没开，按了也没反应；如果光标在编辑器里，它甚至可能被绑定到其他命令上。
常见卡点：
- 按了
Ctrl+Shift+H没反应？先手动按Ctrl+Shift+F打开搜索面板，再按一次Ctrl+Shift+H - Mac 用户输
Cmd+Alt+F失效？那是系统级快捷键（Spotlight），必须用Cmd+Option+F（Option 键即 Alt 键，但 VSCode 文档统一写作Cmd+Option+F） - 面板右上角显示灰色“文档”图标？说明它卡在「当前文件」模式，点 ⋯ → 勾选「在文件中查找」才能切回工作区范围
限定文件类型必须手动填 files to include，不能靠直觉
Ctrl+Shift+H 默认扫描整个工作区，包括 node_modules、dist、.git 等目录——除非你明确告诉它别扫。VSCode 不会自动猜你想改哪些文件。
实操建议：
- 只改 TypeScript 文件：在
files to include输入框填**/*.ts，或更精确的src/**/*.ts - 只改 CSS 类名：填
**/*.css，想排除 legacy.css 就在files to exclude填*/legacy.css - 多个目录组合：用逗号分隔，例如
src/**/*.{ts,js},tests/**/* - 别依赖“点击 … → Add pattern”，容易漏输
**/导致子目录不命中
正则替换必须同时满足三个条件，缺一不可
VSCode 正则替换静默失败是高频问题，原因几乎总是少做了一步。要让 生效，必须：
- 在搜索框右侧点
.*图标（启用正则模式），它变蓝才算开启 - 正则里实际有带括号的捕获组，比如
(\d+)，而不是\d+或(?:\d+) - 替换字段里写
$1，不是\1或$$1（后者才是字面输出$1） - 若需匹配换行符，额外勾选
.*旁边的.按钮（dotAll 模式），否则.不跨行
典型错误示例：查 console\.log\(["'](.+?)["']\)，替换填 debugger; // \1 → 完全不生效，因为 VSCode 只认 $1。
Replace All 不写磁盘，Git 看不到改动就是没保存
Replace All 按钮只修改编辑器内存中的内容，不会自动写入文件系统。标题栏出现 ● 圆点 ≠ 已保存，只是表示“有未保存更改”。
关键动作：
- 替换后必须手动按
Ctrl+S（Windows/Linux）或Cmd+S（macOS）保存全部文件 - 没打开过的文件（比如未在编辑器标签页中加载的
utils.ts）根本不会被Replace All触及——VSCode 只处理已加载进内存的文件 - 右下角显示
Read-only？替换按钮会灰掉，得解除文件只读属性，或用管理员权限重启 VSCode - 建议提前
git add -A && git commit -m "before bulk replace"，替换后立刻git diff核对
最隐蔽的坑：你以为改了 50 个文件，其实只有当前打开的 3 个被真正处理，其余都还在磁盘原样躺着。
