全局单词替换应使用 ctrl+shift+h（win/linux）或 cmd+shift+h（macos），配合“全字匹配”或正则 \bword\b，避免误改子串；ctrl+h 仅限当前文件且不支持全字匹配。
直接用 Ctrl + Shift + H（Windows/Linux）或 Cmd + Shift + H（macOS）打开全局替换面板，再配合 \b 或 “全字匹配”按钮，就能安全替换完整单词——不加约束的纯文本替换，大概率会误改 myFunction 里的 func、字符串中的 "user" 或注释里的 // user id。
为什么 Ctrl + H 不适合全局单词替换
Ctrl + H 只作用于当前打开的文件，不是“全局”。很多人误按后只改了单个文件，还纳闷为啥其他文件没变。真正跨文件夹、全工作区生效的入口只有一个：Ctrl + Shift + H（或 Cmd + Shift + H）。另外，这个快捷键必须在编辑器有焦点时才响应——如果终端（TERMINAL）或调试控制台（DEBUG CONSOLE）处于激活状态，它会完全失效。
怎样确保只替换单词，不碰子串
两种可靠方式，选其一即可：
- 点查找框右侧的
\按钮（图标是ab），启用“全字匹配”。这是最省心的做法，word就不会匹配到keyword或wording。 - 启用正则模式（点
.*按钮），然后输入\bword\b。注意：\b是单词边界，不是反斜杠加字母 b；如果写成bwordb或漏掉任一边，就失去保护作用。 - 别同时开“区分大小写（Aa）”和“全字匹配”，除非你明确要区分
User和user——多数变量名重构场景下，关掉更稳妥。
替换后 import 和路径没更新？这不是 bug，是设计
VS Code 全局替换是纯文本操作，不解析语法。所以：
-
import { formatDate } from './utils'这行里，formatDate是字符串内容，会被\bformatDate\b匹配并替换；但'./utils'是路径字面量，得另起一次搜索，关键词设为./utils，不能指望一次搞定。 - 想只改命名导入里的名字？用正则
import\s+{[^}]*formatDate[^}]*}，再配合$1newName$2类捕获组替换，但务必先预览所有匹配项——VS Code 不提供 diff 预览，点“全部替换”就直接落盘。 - TS 项目中，建议临时关闭
typescript.preferences.includePackageJsonAutoImports，避免自动补全在你替换中途插入新 import，干扰节奏。
大项目里替换卡住或漏文件，先查这三处
VS Code 默认限制单次搜索结果不超过 5000 条，超了就静默截断；另外，files.exclude 和 search.exclude 会悄悄过滤掉目录（比如你加了 "**/*.log"，但目标文件恰好是 api.log，那就搜不到）：
- 右下角搜索面板里，点右上角
Toggle Exclude Settings，确认search.exclude没误排除业务目录（如"src/api/**"）。 - 检查左下角三个图标：
Aa（大小写）、\（全字）、.*（正则）是否按需开启/关闭——重构变量名时，通常要关掉\和Aa，否则UserId和userid就分开了。 - 目标文件若不在当前工作区根目录下，必须先执行
File > Add Folder to Workspace，否则它根本不会被纳入扫描范围。
真正容易被忽略的是：替换前不手动展开替换栏（按 Alt + R 或点“Replace”标签），或者输完词直接回车——那只会执行搜索，不会进入替换流程。还有，正则替换里写 $& 是插入匹配内容，写 $$& 才输出字面量 $，这个错一个符号，整批替换就废了。
