VSCode中TODO注释未高亮或无法集中查看，需启用内置功能、安装Todo Tree扩展、同步设置、配置工作区过滤规则并设置快捷键。
如果您在VSCode中编写代码时添加了TODO注释，但发现这些标记未被高亮显示或无法集中查看，可能是由于相关扩展未启用、设置未配置或工作区语言支持缺失。以下是实现TODO高亮与管理的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用内置TODO高亮功能
VSCode自1.80版本起内置了基础的TODO注释识别能力，无需安装扩展即可对// TODO、/* TODO */等格式进行语法着色，但需确保对应语言的语法定义支持注释范围。
1、打开VSCode，按下Cmd + ,进入设置界面。
2、在搜索框中输入todo，找到Extensions > Todo Tree: Enable选项（若已安装Todo Tree扩展）或确认Editor > Token Color Customizations中未禁用注释颜色。
3、在设置JSON中手动添加高亮规则（如未生效）：
点击右上角“打开设置（JSON）”，插入以下内容：
"editor.tokenColorCustomizations": {
"comments": "#5498FF"
}
4、重启VSCode使配置生效。
二、安装Todo Tree扩展并配置关键词
Todo Tree是一款专用于扫描和聚合TODO类注释的扩展，支持自定义关键词、多级折叠、文件内跳转等功能，可替代基础高亮并提供更强管理能力。
1、点击左侧扩展图标（或按Cmd + Shift + X），在搜索栏输入Todo Tree。
2、找到由Gruntfuggly发布的Todo Tree扩展，点击“安装”。
3、安装完成后，按下Cmd + Shift + P，输入Preferences: Open Settings (JSON)并回车。
4、在settings.json中添加如下配置块：
"todo-tree.general.tags": [
"TODO",
"FIXME",
"BUG",
"HACK"
],
"todo-tree.highlights.defaultHighlight": {
"icon": "check",
"type": "text",
"foreground": "white",
"background": "blue"
},
5、保存文件后，侧边栏将自动出现Todo Tree面板，显示所有匹配项。
三、使用Settings Sync同步TODO配置
当您在多台设备间切换开发环境时，需确保TODO相关设置（如关键词列表、高亮样式、忽略路径）保持一致，Settings Sync可将这些偏好持久化至GitHub账户。
1、点击左下角齿轮图标，选择Turn on Settings Sync...。
2、登录GitHub账户并授权VSCode访问私有仓库权限。
3、在同步选项中勾选Settings与Extensions，确保Todo Tree及其配置被包含。
4、同步完成后，在新设备上登录同一GitHub账户并启用同步，Todo Tree扩展及自定义tags将自动还原。
四、配置工作区级TODO过滤规则
某些项目可能包含大量第三方依赖或生成代码，其中的TODO应被排除在管理视图之外。可通过工作区settings.json单独设定排除路径，避免干扰主开发流。
1、在项目根目录打开.vscode/settings.json（若不存在则新建）。
2、添加以下字段：
"todo-tree.filtering.excludeGlobs": [
"**/node_modules/**",
"**/dist/**",
"**/build/**",
"**/vendor/**"
]
3、保存后，Todo Tree面板将立即刷新，仅显示源码目录下的有效TODO条目。
五、快捷键快速定位与编辑TODO
高频操作可通过键盘快捷方式加速，VSCode支持为Todo Tree绑定专属快捷键，提升从浏览到修改的闭环效率。
1、按下Cmd + K后松开，再按Cmd + S打开键盘快捷方式设置。
2、在搜索框中输入todo tree，找到todo-tree.tree.focus命令。
3、双击该命令右侧空白处，输入组合键Cmd + Option + T并回车确认。
4、再次按下Cmd + Option + T，焦点将直接跳转至Todo Tree面板，支持方向键导航与回车快速打开对应文件。
