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 反而冲突，导致颜色错乱、光标跳动甚至卡顿。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 检查右下角状态栏：显示的是 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></style> 区块内的颜色，<template></template> 里的内联 style 属性需额外配置语言模式为 html 或 vue-html
• 若发现某 CSS 文件没高亮，先右键 → “Change Language Mode” → 选 CSS，别信状态栏自动识别
• 它不支持自定义颜色预览尺寸，小字号代码里色块可能糊成一团，这是目前唯一不可调的硬伤

真正卡住多数人的，从来不是插件装不装，而是 language mode 错配、配置项写错层级、或者多个插件在后台抢高亮控制权——调之前先关掉一半插件，逐个开，比盲目堆配置靠谱得多。