highlight-words 插件必须重启 vscode 才生效，否则高亮不触发；匹配模式需设为 1（whole word）避免误匹配；颜色须用 rgba/hsla 控制透明度；勿与 editor.linehighlightbackground 叠加使用。
highlight-words 插件必须重启 VSCode 才生效
安装完 highlight-words 后不重启，高亮根本不会触发——这是最常被忽略的硬性前提。很多用户反复测试“光标停在变量上按 Ctrl+Shift+P → Highlight Toggle Current”没反应，其实是卡在这一步。插件注册依赖 VSCode 的扩展主机初始化，热安装不等于热加载。
验证是否生效：打开任意 C 或 Python 文件，写一行 int counter = 0;，把光标停在 counter 上，执行命令，看这个词是否立刻被浅蓝底色框住。没反应就关 VSCode 再开一次，别跳过这步。
匹配模式选错会导致误高亮或漏高亮
highlightwords.defaultMode 设为 0（默认）时，是子串匹配：搜 err，error、errno 全中招；设为 1（whole word）才真正只匹配独立单词。嵌入式项目里常见 HAL_OK、HAL_ERROR 并存，不设 whole word 就会互相污染。
- 全词匹配用
1：适合变量名、函数名等精确锚点 - 忽略大小写用
2：适合统一追踪NULL/null/Null - 全词+忽略大小写用
3：C++ 模板参数或宏定义场景更稳妥
颜色配置不用 rgba 就容易遮盖代码
直接填 "#FF0000" 这种纯色会让高亮块像贴纸一样盖住文字，尤其在暗色主题下反差过大。必须用 rgba(255, 0, 0, 0.3) 或 hsla(0, 100%, 50%, 0.25) 控制透明度，让底层代码仍可辨识。
实操建议：
- 主变量用半透明蓝色：
rgba(100, 149, 237, 0.25) - 待修复标记用带边框的红色：
{"light": "rgba(255, 99, 71, 0.3)", "dark": "rgba(220, 20, 60, 0.3)"} - 避免超过 10 种颜色，否则 sidebar 里的高亮列表会变成调色盘，失去定位意义
editor.lineHighlightBackground 和 highlight-words 别混用
editor.lineHighlightBackground 是整行背景色，highlight-words 是单词级高亮，两者叠加会打架：比如当前行有高亮词，背景色和词底色同时作用，可能变成一团糊。真要一起用，得手动调低透明度——editor.lineHighlightBackground 建议设成 "#ffffff10"（极淡白），highlight-words 颜色 alpha 值控制在 0.2–0.3 区间。
更关键的是：editor.lineHighlightBackground 在某些主题（如 One Dark Pro）里默认开启且颜色不可见，得先关掉它再测 highlight-words 效果，否则你以为插件失效，其实是被主题覆盖了。
