WebStorm默认仅高亮光标下标识符，不支持选中文本即全文高亮；需安装BrowseWordAtCaret插件实现该功能，其按字符串匹配高亮，与原生语义用法高亮互不冲突。
WebStorm 默认只高亮光标下的标识符（Identifier under caret），不是“选中后全文高亮”——这是两个不同功能，容易混淆。要实现「选中一个变量名，文件里所有相同单词都高亮」，得靠 BrowseWordAtCaret 插件，而不是默认的用法高亮（Usages）或搜索高亮（Ctrl+Shift+F7）。
为什么默认不支持选中即全文高亮
WebStorm 的原生行为是：仅当光标停在某个符号上（未选中），且启用了「在插入符号移动时高亮显示用法」，才会自动高亮该符号在当前文件中的所有引用。一旦你手动拖选一段文本（比如 userName），它就退化为普通文本选择，不再触发语义高亮。
常见误操作包括：
- 以为勾选了
Settings > Editor > Code Editing > Highlight usages of element at caret就能高亮选中文本——其实它只响应「光标位置」，不响应「鼠标选中」 - 试图用
Ctrl+F搜索再按Enter来模拟高亮——这会跳转，且不保留背景色 - 装了
Rainbow Brackets或Material Theme后误以为它们管单词高亮——它们不负责这个功能
安装并配置 BrowseWordAtCaret 插件
这是目前最稳定、轻量、专为此场景设计的插件，JetBrains 社区长期维护，2026 年仍兼容最新版 WebStorm。
- 打开
Settings > Plugins，右上角搜索框输入BrowseWordAtCaret，点击 Install - 安装完成后必须重启 WebStorm（不重启插件不加载）
- 重启后进入
Settings > Editor > Color Scheme > BrowseWordAtCaret - 勾选右侧的
Background，点击颜色块自定义高亮色（建议用浅黄#FFF9C4或淡蓝#BBDEFB，避免和搜索结果Text search result冲突） - 确认
Enable highlighting for selected text已勾选（部分旧版本插件叫Highlight selected word）
和原生「用法高亮」（Usages）的区别与共存
BrowseWordAtCaret 和 WebStorm 自带的用法高亮可以同时开启，但作用域不同，不会打架：
-
BrowseWordAtCaret：对「任意选中文本」生效，不管是不是变量/函数/关键字，纯字符串匹配（比如选中class，连 HTML 里的class="btn"也会高亮） -
Usages（Highlight usages of element at caret）：只对语言服务识别出的符号生效，比如const foo = 1中的foo，且只高亮它的声明和调用位置，不匹配字符串字面量 - 两者背景色如果设成一样，会叠加变深；建议把
BrowseWordAtCaret设为半透明浅色，Usages用稍深一点的色块，便于区分 - 禁用其中任一功能，都在各自设置页取消勾选即可，互不影响
高亮失效的几个典型原因
装完插件却没反应？先排查这几个点：
- 没重启 WebStorm：插件类路径只在启动时加载，热重载不支持
- 选中的是带空格或标点的文本（如
user.name）：插件默认按单词边界切分，.是分隔符，只会高亮user和name单独出现的位置 - 当前文件类型被识别为
Text files（比如 .svelte 文件没映射到 HTML Files）：插件只在 IDE 能解析语法的文件中启用，纯文本模式下不工作 - 开启了省电模式（Power Save Mode）：所有后台高亮功能都会被强制关闭，状态栏有闪电图标提示
- 配色方案里
BrowseWordAtCaret节点没展开，或右侧Background未勾选——注意它不在General下，而是在独立节点里
真正麻烦的不是装插件，而是理解「选中高亮」和「语义用法高亮」的边界——前者是字符串层面的视觉辅助，后者是语言服务驱动的代码分析。混用时颜色冲突、范围重叠，反而降低可读性。建议先关掉原生用法高亮，用 BrowseWordAtCaret 做基础全文匹配，再按需打开 Ctrl+Shift+F7 查精准引用。
