highlight-words需手动配置settings.json：colors至少两组、defaultMode设3、box.dark为false、showSidebar关；Color Highlight需显式声明languages、开启showColorsInComment、配置正则匹配JS字符串颜色；选中高亮需确保editor.selectionHighlight开启且selectionHighlightBackground为十六进制色值。
highlight-words 怎么配才能让选中词真正高亮
装完插件没反应？不是插件坏了，是 settings.json 里缺关键配置。它不靠 UI 设置面板，必须手写字段，否则颜色压根不渲染。
-
highlightwords.colors至少写两组颜色，比如[{"light":"#b3d9ff","dark":"#4a90e2"},{"light":"#e6ffb3","dark":"#7ed321"}]；只写一组或留空，高亮直接失效 -
highlightwords.defaultMode设为3（全词 + 忽略大小写），避免选中map却把flatMap、mapStateToProps全标出来 -
highlightwords.box的dark字段务必设false：深色主题下若设true，边框会和背景融成一片，看起来像没高亮 -
highlightwords.showSidebar关掉，否则左侧多出 HIGHLIGHTS 栏，干扰文件导航
Color Highlight 为什么某些颜色不显示色块
不是插件失灵，而是它根本没被允许在当前语言里干活。它只认你明文列出来的语言 ID，其他一律跳过。
-
colorHighlight.languages必须显式包含"vue"才能高亮<style scoped></style>里的#42b883；漏了就只在 .css 文件里生效 -
colorHighlight.showColorsInComment设为true，否则// background: #ff6b6b这类注释里的颜色不会渲染 - 如果颜色值在 JS 字符串里（如
const color = "#ff6b6b"），默认不识别；得加自定义正则：{"pattern": "color\s*=\s*"([#a-fA-F\d]{3,8})"", "color": "$1"} - 检查
editor.decorations是否为true：关了这个开关，所有插件装饰（包括色块）全消失
选中变量后全文同名位置不高亮？查这三个地方
VSCode 把“手动选中”“语义匹配”“搜索命中”三类高亮完全隔离，改错一项就白配。
-
editor.selectionHighlightBackground控制双击变量后的淡色背景，必须用十六进制（如"#5a5a5a"），不支持rgb()或命名色 -
editor.selectionHighlight必须为true（默认开），关了这项，语义高亮直接不触发 - 第三方主题可能硬编码覆盖该值，临时切回
Default Dark+验证是不是主题冲突 - 别和
editor.wordHighlightBackground搞混：后者是字面量匹配（选中"foo"就高亮所有"foo"字符串），前者只作用于语言服务识别的符号
跨文件高亮怎么做到不互相覆盖
highlight-words 的多色叠加机制依赖颜色池轮转，但默认行为容易误踩坑——不是颜色不够，是触发方式不对。
- 每次按快捷键（如
Ctrl+Shift+H）只能高亮当前选中词，且自动分配下一个颜色；不能靠鼠标拖选+快捷键重复触发来叠加 - 想同时高亮
apiUrl和timeout？先选apiUrl→ 按快捷键 → 再选timeout→ 再按快捷键；中间不能点别的地方，否则焦点丢失，第二次触发会清掉前一次 - 跨文件生效的前提是：所有目标文件都已打开（非预览态），且未被排除在工作区之外（检查
files.exclude或search.exclude） - 高亮不持久：关掉文件标签页，对应高亮就消失；没有“全局记忆”，纯靠当前编辑器实例维持状态
最易忽略的点：highlight-words 的颜色池是循环复用的，但它的“当前颜色索引”不跨 VSCode 实例保存。重启编辑器后，第一次高亮永远从第一种颜色开始——如果你依赖颜色区分语义（比如蓝色=接口地址，绿色=超时配置），得手动记好顺序或写个脚本初始化。
