ctrl+shift+h（windows/linux）或 cmd+shift+h（macos）才是工作区全局替换的正确快捷键，它扫描整个项目而非仅当前文件；启用正则模式（.*按钮）和合理使用\b、$1等是精准替换的关键。
Ctrl+Shift+H 是全局替换的真正入口，不是 Ctrl+H
很多人误用 Ctrl+H（当前文件内替换）来干跨文件的事，结果只改了当前打开的文件，漏掉几十个 .ts 和 .js 文件。真正触发工作区级全局替换的快捷键是 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）。这个视图默认就带“替换”输入框，不用手动点箭头展开——省一步就少一次误操作。
常见错误现象：Ctrl+H 后狂点“全部替换”，发现 src/utils/api.ts 里的调用没变，因为那文件根本没打开；而 Ctrl+Shift+H 会直接扫描整个工作区，不管文件是否已打开。
- 必须确认右上角显示的是“在工作区中搜索”，不是“在当前文件中”
- 如果项目根目录下有
node_modules，务必在“排除文件”栏填入node_modules,**/dist,**/build，否则可能把依赖包里的字符串也替了 - 第一次执行前，先点“查找全部”，看右侧匹配列表是否合理——尤其注意路径是否落在你关心的业务目录里
正则模式（.* 按钮）不点开，90% 的复杂替换都失败
想把 console.log("user", id) 统一改成 logger.debug({ user: "user", id })？光输文字肯定不行：括号、引号、逗号、空格全得转义，还涉及提取变量。这时候必须点开搜索框右侧的 .* 图标启用正则模式——它不是可选项，是必要开关。
典型踩坑：console\.log$$([^)]+)$$ 这种写法在非正则模式下会被当字面量处理，根本搜不到任何内容；点了 .* 后，$$ 才代表左括号，[^)]+ 才真正匹配参数内容。
- 捕获组用
()，替换时用$1、$2引用，比如console\.log$$"([^"]+)"$$→logger.info("$1") - 多行匹配必须配合
\n，例如匹配函数体注释：(function\s+\w+\(\)\s*\{\n\s*)// TODO.*?\n(\s*return) - 大小写敏感和全字匹配（
Aa和\b）建议分开控制：先关Aa做宽泛匹配，预览后再开Aa或加\b收窄
“全字匹配”按钮（\b）和正则 \b 不是一回事，但效果常一样
点一下搜索框旁的 \ 图标（显示为“全字匹配”），VS Code 就自动给你套上单词边界逻辑，等价于正则里的 \bword\b。它对 userId 和 userIds 能正确区分，不需要手写 \b。
但要注意：这个按钮只作用于纯文本匹配。一旦你启用了正则模式（.* 已点亮），\ 按钮就失效了——此时必须自己写 \b，比如想只替换独立的 data，就得搜 \bdata\b，而不是依赖按钮。
- 简单场景（如替换变量名
res→response）优先点\按钮，快且安全 - 复合场景（如
res.status保留，只改单独的res）必须切正则 +\bres\b -
\b在中文环境基本无效，遇到中英文混排字段（如用户ID）得靠上下文锚定，比如(?
替换后不保存 = 白干，而且没提示
VS Code 执行“全部替换”后，所有被修改的文件只是在编辑器里变了，**不会自动保存到磁盘**。如果你接着关窗口、切分支、甚至重启 VS Code，未保存的修改就丢了——它连“文件已更改，是否保存？”都不弹。
这是最隐蔽也最致命的疏漏。尤其当你批量改了 20+ 个文件，预览觉得没问题，点完“全部替换”就去跑测试，结果测试报错，才发现 src/api/index.ts 根本没写入硬盘。
- 替换完成后，立刻按
Ctrl+Shift+S（全部保存），别信状态栏有没有“●”标记 - 更稳妥的做法：替换前先
git add -u && git commit -m "prep for rename"，避免手抖覆盖 - 如果项目开了“Auto Save”，记得确认它是 “afterDelay” 或 “onFocusChange”，而不是 “off”——很多团队默认关着
