PhpStorm需安装BrowseWordAtCaret插件并启用“Browse Word at Caret”选项,再于Color Scheme中设置BrowseWordAtCaret背景色,方可实现双击单词高亮全文匹配项。

PhpStorm 默认不开启“选中词高亮”,必须手动启用插件并配置,否则双击变量名只会选中,不会标记全文所有匹配项。
怎么启用 BrowseWordAtCaret 插件
这个功能不是内置开关,而是依赖一个官方维护的轻量插件:
- 打开
Settings / Preferences → Plugins - 在 Marketplace 搜索框输入
BrowseWordAtCaret - 找到作者为
JetBrains的同名插件(不是第三方“Word Highlighter”之类) - 点击
Install,安装后重启 PhpStorm
注意:2022.3+ 版本已将该插件设为默认启用,但部分定制安装或旧项目配置里仍可能被禁用,建议手动确认是否勾选。
如何开启并调高亮颜色
插件装好只是第一步,真正控制高亮行为的是两个独立设置项:
- 启用逻辑:进入
Settings → Editor → General → Appearance,勾选Browse Word at Caret - 调颜色:进入
Settings → Editor → Color Scheme → BrowseWordAtCaret,改Background(不是 Foreground)——这是实际高亮区域的底色 - 如果颜色太浅看不清,别只调亮度,直接换明确色值如
#ffffcc或#e6f3ff,Opacity 保持 100%
常见错误:在 Color Scheme → General 下调 Identifier 颜色,这影响的是变量名本身,和选中高亮无关。
为什么有些变量点不亮、或者只亮一部分
高亮失效往往不是插件问题,而是语义识别没到位:
- 检查右下角状态栏:如果显示的是
HTML或Text而非PHP,说明文件类型没识别对,右键文件 →Override File Type → PHP - 混合文件(如
.blade.php或含<?php ?>的 HTML)中,$user可能走的是HTML → PHP code配置路径,得去那里单独开高亮 - 用了
@param $foo这类 PHPDoc 注解?这类变量名归Doc comment tag value管,不受BrowseWordAtCaret影响 - 函数参数名(
function foo($x)中的$x)在旧版本里可能不参与高亮,升级到 2023.3+ 可修复
真正容易被忽略的是:高亮范围严格依赖 PhpStorm 的语法解析结果。如果你改了变量名但没触发重解析(比如刚粘贴完没敲空格),它可能还缓存着旧结构——敲个空格或按一下 Ctrl + Shift + O 强制重载就能刷新。这不是 bug,是 IDE 为性能做的取舍。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










