vs code的“全字匹配”不识别下划线、美元符和驼峰大写为单词边界，需用正则模式加\buser\b实现真正全词匹配。
为什么“全字匹配”按钮有时没用
点开 Ctrl + Shift + H 后勾选了 ab（全字匹配）图标，但 user 还是把 username 里的 user 给替换了——这不是 bug，而是 VS Code 的“全字匹配”只认空格、换行、括号、点号等 ASCII 标点为单词边界，不识别 _、$ 或驼峰大写字母。比如 user_name 中的 user 仍会被匹配，因为下划线不算边界。
真正可靠的完整单词匹配：必须用 \b 正则
启用正则模式（点 .* 图标），在查找词前后加 \b，例如：\buser\b。这个 \b 是 JavaScript 正则引擎定义的“单词边界”，能正确区分 user 和 username、user_id、getUser。
- 想排除注释和字符串？得叠加上下文，比如
(?（需手动验证是否兼容当前 VS Code 版本） - 只在 TS/JS 文件生效？在“文件包含”框填
*.ts,*.js（逗号后不加空格） - 替换前务必点“查找全部”，看预览列表里有没有漏掉或误伤的项——VS Code 不会高亮
\b边界，全靠肉眼核对上下文
常见误操作导致“看似全字匹配失效”
你以为关了大小写就安全了？其实不是。
-
Match Case（Aa按钮）开着时，\bUser\b不会匹配小写的user；关了才统一处理，但要注意可能误中USER -
search.exclude里如果写了**/test/**，而你要改的文件恰巧在src/test/utils.ts，它就被静默跳过——检查左下角“Toggle Exclude Settings”才能发现 - 工作区没加载目标文件夹？右键文件夹 →
Add Folder to Workspace，否则Ctrl + Shift + H根本扫不到它
TS 项目里改函数名，光靠 \b 还不够
比如把 formatDate 改成 dateFormat，\bformatDate\b 能避开 formatDateHelper，但无法区分 import { formatDate } from './utils' 和 const d = formatDate()。后者要改，前者里的 formatDate 是导入名，语义不同。
- 调用场景优先用
\bformatDate\s*\(\)（后面紧接括号） - 导入语句单独搜：
import[^;]*\bformatDate\b，再人工筛选花括号内还是别名 - 路径字符串（如
'./utils'）完全不参与\b匹配，必须另起一次搜索，关键词就是原始路径字面量
\b，而是你忘了 VS Code 的全局替换不理解代码结构——它不管你是改变量、改 import 名、还是改字符串里的单词。每个上下文都得拆开验，每个排除规则都得亲手点开确认。
