VSCode 中需安装 TODO Highlight 插件并配置 keywords、tags 和 excludeGlobs 才能稳定高亮 TODO/FIXME/XXX 等待办注释；自定义标签需在 todoHighlight.keywords 中添加 JSON 规则；全局扫描与侧边栏聚合需启用 todo-tree 插件并配置 enableGlobalCommandPalette 和 tags；排除 node_modules 等路径可避免误匹配。
如果您在 VSCode 中编写代码时希望自动高亮标记如 TODO、FIXME、XXX 等待办注释，但插件未生效或高亮不完整，则可能是配置缺失或规则未正确加载。以下是实现稳定、精准高亮的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 TODO Highlight 插件
该插件是 VSCode 社区中广泛使用的轻量级高亮工具，通过语法匹配在编辑器中为指定关键词添加背景色与装饰线，无需修改代码即可视觉强化待办项。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在搜索框中输入 TODO Highlight，找到作者为 wayou 的插件。
3、点击“安装”，安装完成后点击“重新加载”使插件生效。
二、配置自定义高亮关键词与样式
默认配置仅识别 TODO、FIXME、XXX，若项目中使用了 CUSTOM_TASK、REVIEW_ME 等自定义标签，需手动扩展正则规则，确保所有待办语义均被覆盖。
1、按下 Cmd+,（macOS）打开设置界面，切换至“JSON”编辑模式（右上角点击打开 settings.json）。
2、在 "todo-tree.tree" 或 "todo-highlight.keywords" 节点下添加如下结构（若无则新建）：
3、插入以下 JSON 片段：
"todoHighlight.keywords": [ { "text": "CUSTOM_TASK", "color": "#ff8c00", "backgroundColor": "#ffd54f", "overviewRulerColor": "#ff8c00" }, { "text": "REVIEW_ME", "color": "#e91e63", "backgroundColor": "#f8bbd0", "overviewRulerColor": "#e91e63" } ]
三、启用跨文件全局扫描与侧边栏聚合
仅编辑器内高亮不足以管理复杂项目中的待办事项，启用全局扫描可将所有匹配项汇总至侧边栏树状视图，支持快速跳转与分类筛选。
1、在 settings.json 中添加配置项："todo-tree.general.enableGlobalCommandPalette": true。
2、添加："todo-tree.general.tags": ["TODO", "FIXME", "XXX", "CUSTOM_TASK", "REVIEW_ME"]。
3、重启 VSCode 后，点击左侧活动栏的 TODO Tree 图标，即可查看当前工作区全部待办节点。
四、排除特定文件或目录避免误匹配
某些生成文件（如 dist/、node_modules/、.next/）可能包含大量无关 TODO 字符串，导致高亮干扰与性能下降，需主动排除这些路径。
1、在 settings.json 中定位到 "todo-tree.general.excludeGlobs" 配置项。
2、将其值设为数组格式，例如：["**/node_modules/**", "**/dist/**", "**/.next/**", "**/build/**"]。
3、保存后，插件将跳过这些路径下的文件解析，提升响应速度并减少噪声。
