VSCode需通过组合设置与插件实现引用高亮：启用editor.selectionHighlight、确认语言模式、开启editor.decorations、关闭occurrencesHighlight，并为highlight-words插件配置colors等参数。
VSCode 原生不支持“点击即高亮所有引用”的交互，但可以通过组合设置 + 插件实现稳定、可预测的当前符号引用高亮效果。关键不是开一堆开关，而是理清三类高亮机制的分工：语义引用（Shift+F12）、选中词匹配（editor.selectionHighlight）、手动触发高亮（highlight-words插件）——混用反而失效。
为什么双击变量没反应？先检查 editor.selectionHighlight 和语言模式
这是最常被跳过的前置条件。即使你装了插件，如果这个基础开关关着，连最简单的同词高亮都不会触发。
- 按下
Cmd+,打开设置，搜索selection highlight，确保Editor > Selection Highlight已勾选 - 右下角状态栏确认语言模式不是
Plain Text；如果是，点击切换为对应语言（如TypeScript、Python） - 若仍无效，运行命令面板（
Cmd+Shift+P），输入Developer: Toggle Developer Tools，在 Console 里执行monaco.editor.getTheme()，确认主题未禁用装饰器（第三方主题常默认关闭editor.colorDecorators）
highlight-words 插件必须手动配置才生效
只安装不配，插件完全静默。它不读 UI 设置，只认 settings.json 里的显式声明，且至少要定义两种颜色（明/暗主题）和匹配模式。
- 安装插件后，打开
Preferences: Open Settings (JSON) - 在根对象内添加以下配置（注意逗号分隔）：
"highlightwords.colors": [
{
"color": "#ffcc0044",
"filter": "\b${word}\b"
}
],
"highlightwords.defaultMode": 3,
"highlightwords.box": false
defaultMode: 3 表示全词匹配 + 忽略大小写，避免 map 错配到 flatMap；box: false 在深色主题下防止边框与背景融合导致“看不见高亮”。
想高亮“语义引用”而非纯文本？关掉 editor.occurrencesHighlight
VSCode 自带的 occurrencesHighlight 是悬停时自动高亮引用，但它和 highlight-words 冲突，且对 _ 开头变量默认不识别。如果你要的是“光标停在哪，就高亮哪的语义引用”，必须关掉它：
- 在设置中搜索
occurrences highlight，把Editor > Occurrences Highlight设为false - 同时确保
editor.semanticHighlighting也为false，否则_temp、__private这类变量名不会被纳入匹配范围 - 若需跨文件高亮，启用
highlightwords.persist（v1.5+ 支持）
别忽略 editor.decorations 这个底层开关
所有高亮（包括括号匹配、Color Highlight、highlight-words）最终都靠 VSCode 的 decoration 机制渲染。这个开关被悄悄关掉时，没有任何报错，但所有高亮全消失。
- 搜索设置项
editor.decorations，确认值为true - 某些性能优化类插件或旧版主题会重置它，建议在
settings.json里显式写入："editor.decorations": true
真正难调的不是颜色值，而是这四个层级的开关是否全部对齐：语言服务激活 → 装饰器启用 → 基础高亮开关开启 → 插件配置无遗漏。少一个，高亮就断在半路。
