vscode-highlight插件不生效主因是正则配置错误（如反斜杠转义不足、捕获组与装饰对象数量不匹配）、未正确写入settings.json、或未重启窗口；需严格按json格式书写正则（如\//），并确保highlight.regexes数组结构完整。
vscode-highlight 插件装完没反应？不是插件坏了，大概率是正则写错、转义漏了，或者配置没进对的 settings.json 文件。
为什么 vscode-highlight 配置后不生效
常见现象是：写了 // TODO，但没高亮；或高亮了，但颜色不对、范围过大。根本原因在于插件依赖正则匹配 + 捕获组装饰，而 VS Code 的 JSON 配置对反斜杠极其敏感。
- 正则中每个
在 JSON 里必须写成\，比如匹配//要写"\\//"，少一个就完全不匹配 -
highlight.regexes必须放在用户级（User）或工作区级（Workspace）的settings.json中，不能只在 GUI 设置里点几下就完事 - 插件默认不启用任何规则，空配置等于没配 —— 它不会自动高亮
TODO或FIXME，全靠你手动定义
highlight.regexes 的正确写法与常见错误
配置本质是数组，每项是一个“正则 → 装饰规则”映射。关键不是语法多炫酷，而是捕获组数量和装饰数组长度必须严格一致。
- 错误写法：
"(//TODO:)(.*)" : [{ "color": "yellow" }]→ 两个捕获组，但只给了一个装饰对象，第二组被忽略 - 正确写法：
"(//TODO)(:)(.*)" : [ { "color": "red" }, { "color": "#00f" }, { "backgroundColor": "#ffeb3b", "color": "#000" } ]→ 三个组，三个装饰对象 - 想全局匹配整行？用
^.*TODO.*$，但注意^和$在 VS Code 正则里默认不启用多行模式，需加标志(?m)
如何快速验证配置是否生效
别靠猜，直接用 VS Code 自带的「测试正则」功能：
- 打开任意代码文件，按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，打开控制台 - 在控制台里粘贴你的正则，用 JavaScript 的
new RegExp(...).test("你的测试文本")验证逻辑 - 更直观：安装
Regex Preview插件，它能在编辑器侧边实时显示正则匹配结果 - 改完
settings.json后，**必须重启 VS Code 窗口**（不是重载窗口），否则新规则不加载
容易被忽略的性能陷阱
高亮是实时触发的，正则太重会拖慢滚动和输入响应，尤其在大文件里。
- 避免使用贪婪量词
.*匹配超长行，改用非贪婪.*?或限定长度.{0,100} - 不要在
highlight.regexes里塞几十条规则 —— 每条都参与全文扫描，5 条以上就可能感知卡顿 - 如果只希望在特定语言里生效（比如只高亮 JS 文件里的
TODO），要用"language": "javascript"字段限定，而不是靠正则硬扛
真正难的不是写对第一条高亮规则，而是后续维护时忘记某条正则在哪个 settings.json 里、有没有被工作区设置覆盖、或者某次升级后插件悄悄改了字段名 —— 这些细节比语法本身更容易让高亮突然失效。
