highlight-words 插件安装后必须重启 VSCode 才能生效，否则高亮不出现；匹配模式需按场景选 whole word（1）或 ignore case（3）；颜色配置须用 rgba/hsla 控制透明度；预设词需手动激活。
highlight-words 插件必须重启才能生效
装完 highlight-words 后直接试，大概率高亮不出现——不是配置错，是插件没真正加载。VSCode 对这类依赖注入的插件要求严格，安装后必须手动重启编辑器。遇到光标悬停无反应、Ctrl+Shift+P 找不到 Highlight Words: Toggle Highlight 命令，基本就是这个原因。
常见错误现象：
- 插件已安装但快捷键
F8无响应 - settings.json 已写入配置，但颜色没变化
- 右键菜单里没有 “Highlight Word” 选项
实操建议：
- 安装后立刻关掉所有 VSCode 窗口（包括后台进程），再重新打开
- 用测试代码验证：写一个
counter变量，光标放上去按F8，看是否全文件同名变量被框住 - 别在“设置 UI”里改插件开关，直接去
settings.json编辑更可靠
匹配模式选错会导致误高亮或漏高亮
highlightwords.defaultMode 的取值直接影响语义准确性。默认值 0 是模糊匹配，比如高亮 log，结果 logger、dialog 全被染色；而 1（whole word）才真正只匹配独立单词。
使用场景差异：
- 查变量名、函数名 → 用
1（whole word） - 查调试关键字如
DEBUG，且不区分大小写 → 用3（whole word + ignore case） - 临时搜缩写词如
cfg，又想连带config一起看 → 用2（ignore case），但需配合正则排除干扰
性能影响：模式越宽松，扫描范围越大，大文件里可能卡顿 1–2 秒；1 和 3 因精确匹配，响应更快。
颜色配置不加透明度会遮盖语法高亮
直接套用十六进制色值如 "#FF5733"，在暗色主题下容易把变量名整个盖住，看不见括号、运算符甚至分号。这是因为 highlight-words 默认用背景色填充，而非叠加图层。
正确做法是用 rgba 或 hsla 控制透明度：
-
"rgba(255, 87, 51, 0.3)"—— 红色半透明，保留底层语法色 -
"hsla(12, 100%, 60%, 0.4)"—— 更易在明/暗主题间统一观感 - 避免用纯白
#FFFFFF或纯黑#000000，对比度过高反而伤眼
容易踩的坑：复制网上配置时漏掉最后一位 alpha 值，或者误写成 rgb(255,87,51,0.3)（缺少 a），VSCode 会静默忽略整条颜色规则。
全局高亮和文件级高亮要分开管理
highlightwords.showSidebar 设为 true 后，侧边栏出现 HIGHLIGHTS 区，但它默认只显示当前文件的高亮词。如果想跨文件追踪同一个变量（比如 C 项目里全局 HAL_StatusTypeDef），必须手动在每份文件里按 F8，不能靠 sidebar 自动同步。
实操要点：
- 长期跟踪的关键词，建议用
highlightwords.words配置数组预设，例如："highlightwords.words": ["HAL_OK", "HAL_ERROR", "HAL_BUSY"] - 临时标记用快捷键，永久标记走预设，混用才不乱
- 预设词不支持通配符或正则，
"HAL_*"这种写法无效，得列全
真正容易被忽略的是：预设词在新打开的文件里不会自动触发，必须先聚焦到该文件，再按一次 F8 才激活——这不是 bug，是插件设计限制。
