highlight-words插件需设highlightwords.defaultMode为1（全词匹配）避免误高亮，colors数组精简至4–5种高对比度色，box设为true加边框提升辨识度，安装后必须重启VSCode方可生效。
VSCode 默认的语法高亮对复杂项目远远不够，光靠主题配色解决不了变量追踪、括号嵌套、待办遗漏这些真实阅读疲劳点——必须组合使用几类高亮插件，并且每类都要调对关键配置，否则容易白装。
highlight-words 插件怎么配才不翻车
它不是装上就高亮，核心在于 highlightwords.defaultMode 和颜色数组设置。默认模式 0（普通匹配）会导致 a 高亮时把 ab、array 全带进去，根本没法用。
- 必须设为
1（whole word），避免误匹配；需要忽略大小写时再叠加3 -
highlightwords.colors数组建议精简到 4–5 种高对比度颜色，暗色主题下慎用浅灰、淡黄 - 别漏掉
highlightwords.box: true，加边框比纯背景色更醒目，尤其在注释行或字符串里 - 安装后必须重启 VSCode，否则
Highlight Toggle Current命令不注册
括号高亮失效？先看 language mode 和原生开关
VS Code 1.68+ 已内置括号配对高亮，但很多人装了 Bracket Pair Colorizer 2 反而冲突，导致颜色错乱、光标跳动甚至卡顿。
- 检查右下角状态栏：显示的是
C还是Plain Text？错选语言模式，高亮直接退化成字符级匹配 - 确认设置项
editor.bracketPairColorization.enabled为true - 禁用所有第三方括号插件，重启后再测试——原生功能无兼容风险，响应更快
- 如果仍异常，可能是 Prettier 或 ESLint 扩展在格式化时临时压制了高亮层，可临时禁用它们验证
TODO/FIXME 高亮为什么只在部分文件生效
默认配置下 TODO Highlight 会扫描所有打开的文件，包括 .md、.log、.json，不仅干扰视线，还拖慢大项目加载。
- 用
todoHighlights.include显式限定语言：比如["**/*.ts", "**/*.js", "**/*.py"] - 自定义关键词时，
pattern必须是完整单词，不要写正则元字符（如NOTE:会漏掉末尾无冒号的情况） -
overviewRulerColor建议和color保持色系一致，否则侧边栏色块和行内高亮脱节 - 跨设备同步配置时，
settings.json中的todoHighlights段要完整复制，漏掉include就全失效
颜色值高亮插件 vs code-ext-color-highlight 的隐藏限制
它能渲染 #ff0000、rgb(255, 0, 0)、red，但对 CSS 变量（var(--primary)）或 Sass $color-primary 完全无感——这不是 bug，是设计边界。
- 只作用于标准颜色字面量，不解析变量引用链
- 在
.vue单文件组件中，仅高亮<style>区块内的颜色，<template>里的内联style属性需额外配置语言模式为html或vue-html - 若发现某 CSS 文件没高亮，先右键 → “Change Language Mode” → 选
CSS，别信状态栏自动识别 - 它不支持自定义颜色预览尺寸，小字号代码里色块可能糊成一团，这是目前唯一不可调的硬伤
真正卡住多数人的，从来不是插件装不装，而是 language mode 错配、配置项写错层级、或者多个插件在后台抢高亮控制权——调之前先关掉一半插件，逐个开，比盲目堆配置靠谱得多。
