PhpStorm需安装BrowseWordAtCaret插件并启用“Browse Word at Caret”选项，再于Color Scheme中设置BrowseWordAtCaret背景色，方可实现双击单词高亮全文匹配项。
PhpStorm 默认不开启“选中词高亮”，必须手动启用插件并配置，否则双击变量名只会选中，不会标记全文所有匹配项。
怎么启用 BrowseWordAtCaret 插件
这个功能不是内置开关，而是依赖一个官方维护的轻量插件：
- 打开
Settings / Preferences → Plugins - 在 Marketplace 搜索框输入
BrowseWordAtCaret - 找到作者为
JetBrains的同名插件（不是第三方“Word Highlighter”之类） - 点击
Install，安装后重启 PhpStorm
注意：2022.3+ 版本已将该插件设为默认启用，但部分定制安装或旧项目配置里仍可能被禁用，建议手动确认是否勾选。
如何开启并调高亮颜色
插件装好只是第一步，真正控制高亮行为的是两个独立设置项：
立即学习“PHP免费学习笔记（深入）”；
- 启用逻辑：进入
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 为性能做的取舍。
