highlight-words 配置必须重启 VSCode 才生效，安装后需完全重启而非仅关闭窗口；确认语言模式正确、颜色配置带透明度、匹配模式按需选择、特殊语言需先确保语言服务正常。
highlight-words 配置必须重启 VSCode 才生效
插件安装后不重启，highlight-words 的任何配置都不会加载——这是最常被忽略的硬性前提。你改了 settings.json、调了颜色、设了匹配模式，但光标悬停没反应、F8 快捷键无效，大概率就是卡在这一步。
实操建议：
- 安装插件后立即关闭并重启整个 VSCode（不是仅关窗口）
- 重启后打开任意 C/C++ 或 TypeScript 文件，用
Ctrl+Shift+P输入Highlight Words: Toggle Highlight测试是否可触发 - 确认右下角语言模式正确（比如
.cpp文件显示 “C++”，不是 “Plain Text”）——否则高亮范围会错乱甚至失效
颜色配置别只抄默认值，要带透明度和语义区分
默认的 highlightwords.colors 数组用的是纯色，暗色主题下容易盖住语法高亮，尤其在嵌套结构里看不清变量名本身。直接复制粘贴进 settings.json 很可能让代码变得“更难读”。
实操建议：
- 用
rgba(100, 149, 237, 0.4)这类带 alpha 通道的值，避免遮挡底色 - 按语义分层：比如
"#FF6B6B"专用于待修复标记，"#4ECDC4"用于关键函数调用，"#FFE66D"用于调试临时变量 - 颜色数量控制在 6–10 种以内，再多就失去快速识别意义
- 不要在
workbench.colorCustomizations里重复覆盖高亮色——它只影响 UI 元素，不影响highlight-words渲染
匹配模式选错会导致误高亮或漏高亮
highlightwords.defaultMode 不是“越严格越好”。设成 1（whole word）能避免 a 匹配到 ab，但在宏定义或缩写场景（如 HAL 出现在 HAL_GPIO_TogglePin 里）反而漏掉关键上下文。
实操建议：
- C/C++ 项目推荐用
3（whole word + ignore case），兼顾大小写混用和词边界 - 调试阶段临时高亮某个变量名时，手动用
Ctrl+Shift+P → Highlight Words: Highlight Current Word，它走的是当前光标词的精确匹配，不受 defaultMode 影响 - 避免全局启用
highlightwords.showSidebar：侧边栏列出所有高亮词后，一旦项目里有大量同名变量（比如几十个ret），列表会卡顿且无筛选功能
Vue / Protobuf 等特殊语言必须先解决语言服务，再谈高亮
highlight-words 是文本级匹配，它不管语法树。如果你在 .vue 文件里高亮 ref 却发现 <template></template> 区域完全不响应，或者 .proto 里高亮 message 但 import 路径全红——问题根本不在高亮插件，而在语言识别失败。
实操建议：
- Vue 3 项目：确保已禁用
Vetur，装了Volar，且右下角语言模式明确显示 “Vue”，否则highlight-words只能在<script></script>块生效 - Protobuf 项目：必须配置
protobuf.protocPath为绝对路径，且插件已加载（打开文件夹后状态栏出现 “protobuf” 图标），否则.proto被当纯文本处理，高亮只作用于字符层面，无法关联字段或 service - 别指望
highlight-words替代语法高亮：它不能识别const是关键字还是普通变量名，这类需求得靠editor.tokenColorCustomizations或对应语言插件
真正卡住人的从来不是怎么配，而是配完发现没效果——多数时候是语言模式没对、插件没加载、或者把文本高亮和语法高亮当成一回事。盯住右下角那个小标签，它比任何配置都诚实。
