VSCode插件让你的代码高亮更具个性-VSCode-PHP中文网

必须重启vscode才能使highlight-words插件生效，因其依赖启动时加载；配置需区分light/dark主题颜色，作用域可通过files/exclude控制，建议保留3–4种高频词高亮以平衡可用性与清晰度。

vscode插件让你的代码高亮更具个性

VSCode 默认的语法高亮只按语言规则染色，没法标记你关心的特定单词（比如 TODO、FIXME、变量名 userToken 或调试用的 debugLog）。想让这些词“跳出来”，必须用 highlight-words 这类插件，而不是改 editor.tokenColorCustomizations —— 后者只管语法结构，不管具体词内容。

安装 highlight-words 后必须重启 VSCode

很多人装完就试，发现光标停在单词上没反应，直接以为插件坏了。其实根本原因是没重启。VSCode 的插件注册机制要求部分插件（尤其是监听编辑器事件的）在启动时加载，热安装不触发完整初始化。

安装后立即按 Ctrl+Shift+P → 输入 Developer: Reload Window 手动重载，比关再开更快
验证是否生效：打开任意 .js 文件，写 const test = 123;，把光标停在 test 上，按 Ctrl+Shift+P → 输入 Highlight Words: Highlight Current Word，看是否有高亮框出现
如果仍无效，检查有没有其他插件冲突（比如某些主题插件会覆盖高亮边框样式）

颜色配置必须区分 light/dark 主题

highlightwords.colors 数组里每个对象都要同时提供 light 和 dark 字段，否则暗色主题下可能完全看不见高亮，或颜色糊成一片。VSCode 不会 fallback，缺哪个就用默认灰。

VSCode

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

下载

别直接复制网上别人配的十六进制色值，先在 settings.json 里写好结构，再一个个试：

"highlightwords.colors": [
  { "light": "#FFD700", "dark": "#FFA500" },
  { "light": "#90EE90", "dark": "#32CD32" }
]

浅色主题下慎用浅黄、浅粉；深色主题下避免纯白、淡灰 —— 它们和背景对比度太低
8 种颜色不是上限，数组可以扩到 12 个，但超过 6 个后人眼很难快速分辨，建议按语义分组：调试类、待办类、风险类、临时类

高亮范围容易误配成全局生效

默认配置是全局高亮所有匹配词，但在大型项目里，你只想在当前文件或某类文件（如 .ts）里高亮 TODO，否则满屏都是金黄色块，反而干扰阅读。

用 highlightwords.files 控制作用域：

"highlightwords.files": ["**/*.ts", "**/*.js"]

用 highlightwords.exclude 排除干扰路径：

"highlightwords.exclude": ["**/node_modules/**", "**/dist/**"]

如果只想高亮当前光标所在单词（而非所有同名词），确保关闭 highlightwords.highlightAllMatches，设为 false

真正难的是平衡：颜色太多眼花，太少不够用；全局高亮信息过载，局部高亮又得反复开关。最实用的做法是留 3–4 种固定色给高频词（TODO、FIXME、console.log），其余按需临时添加，用完删掉 —— 高亮不是装饰，是导航工具，得随时能清空重来。