VsCode插件TodoTree如何忽略某些文件夹？TaoToken配置骨架与验证清单

1. 为什么 TodoTree 一开就满屏噪音TodoTree 是 VS Code 里一个把// TODO、// FIXME、// HACK这类注释聚合成侧边栏树形列表的插件。它本身不写代码只做一件事扫描工作区里的文件把匹配到的标记按目录结构列出来点一下就能跳转。适合谁适合那种项目里 TODO 散落在几十个文件、靠 CtrlShiftF 搜又嫌乱的人。问题出在默认扫描范围。你打开一个前端项目node_modules里成千上万个包每个包里都可能带着原作者写的 TODOdist、build、.next、coverage这些产物目录同样一堆。结果就是侧边栏刷出几千条待办真正属于你业务代码的那几条被淹得看不见。我试过在一个中型项目里不配忽略规则TodoTree 直接卡住好几秒才渲染完列表里 95% 是第三方依赖的注释。所以核心诉求很明确让 TodoTree 只扫业务代码目录把依赖、产物、缓存、日志全部挡在门外。这件事靠settings.json里的todo-tree.filtering.excludeGlobs就能解决不需要改插件源码也不需要装额外扩展。下面从配置骨架讲到逐项验证顺带把 TaoToken 的 Key/API 通道校验一起串起来——因为很多人在配环境变量时会把 Key 写错位置导致工具链报错却找不到原因统一走一个通道能省不少排查时间。2. TaoToken 前置统一 Key 与 API 通道在动手改 TodoTree 配置之前先把环境通道理清楚。TaoToken 是一个统一的大模型 API 接入层官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的作用是让你用一套 Key 去调用不同模型不用在每个工具里分别填不同厂商的地址和密钥。为什么配 TodoTree 要提这个因为实际开发里TodoTree 扫出来的待办经常要配合 AI 辅助去处理——比如把 TODO 列表丢给模型做优先级排序或者在编码 Agent 里自动读取待办。如果你的 Key 散落在多个配置文件里一旦某个工具报 401你根本分不清是 Key 过期、地址写错还是环境变量没加载。统一走 TaoToken 之后所有工具读同一个TAOTOKEN_API_KEY排查面就收窄了。你需要先拿到 Key。进入控制台创建https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 然后在 API Keys 页面生成https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。生成后复制那串以sk-开头的字符串先别急着写进项目放到系统环境变量里更安全。# macOS / Linux写入 shell 配置 echo export TAOTOKEN_API_KEYsk-你的实际Key ~/.zshrc source ~/.zshrc # Windows PowerShell写入用户级环境变量 [Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, sk-你的实际Key, User)验证环境变量是否生效# macOS / Linux echo $TAOTOKEN_API_KEY # Windows PowerShell新开一个窗口 $env:TAOTOKEN_API_KEY能打印出完整 Key 就说明通道就绪。这一步做完后面 TodoTree 的配置校验才有统一的参照物——你可以用同一个 Key 去测模型对话、测 Coding Plan确认不是通道问题再回头查插件配置。3. 可复制的 settings.json 忽略配置骨架TodoTree 的过滤配置分两层一层是todo-tree.filtering.excludeGlobs决定哪些路径不扫描另一层是todo-tree.filtering.includeGlobs决定只扫描哪些路径。两者可以配合用但最省事的是只配 exclude把噪音目录列全。打开 VS Code按CtrlShiftPmacOS 是CmdShiftP输入Preferences: Open User Settings (JSON)在打开的settings.json里加入下面这段。如果你只想对当前项目生效就改成打开工作区的.vscode/settings.json。{ todo-tree.filtering.excludeGlobs: [ **/node_modules/**, **/dist/**, **/build/**, **/out/**, **/.next/**, **/.nuxt/**, **/coverage/**, **/.cache/**, **/tmp/**, **/logs/**, **/*.min.js, **/*.min.css, **/*.map, **/vendor/**, **/__pycache__/**, **/.venv/**, **/venv/**, **/target/**, **/.git/** ], todo-tree.filtering.includeGlobs: [ **/src/**, **/app/**, **/lib/**, **/components/** ], todo-tree.filtering.useBuiltInExcludes: fileExcludesAndSearchExcludes, todo-tree.general.tags: [ TODO, FIXME, HACK, XXX, BUG ], todo-tree.highlights.defaultHighlight: { foreground: #ffffff, background: #ff6b35, type: text } }逐项说明关键参数。excludeGlobs是数组每一项是一个 glob 模式**/表示任意层级/**表示目录下所有内容。useBuiltInExcludes设为fileExcludesAndSearchExcludes后TodoTree 会自动继承 VS Code 的files.exclude和search.exclude设置你不用重复写一遍。includeGlobs是可选的如果你项目结构规整直接限定只扫src就够了比列一长串 exclude 更干净。注意 glob 的写法坑**/node_modules和**/node_modules/**效果不同。前者匹配目录本身后者匹配目录下所有文件。实测下来写**/node_modules/**才能彻底挡住里面的文件。另外*.min.js这种要写成**/*.min.js否则只匹配根目录。如果你用的是工作区配置记得.vscode/settings.json会覆盖用户级配置两边都写了 exclude 的话以工作区为准。改完保存TodoTree 会自动重新扫描不需要重启 VS Code。4. 验证请求与成功结果配置写完不能只看侧边栏变没变要做几个确定性验证。第一步确认插件读到了你的配置。按CtrlShiftP输入Todo Tree: Refresh强制重扫。然后打开 TodoTree 侧边栏看列表顶部有没有出现node_modules相关的条目。正常情况下应该一条都没有。第二步用命令面板查实际生效的排除规则。按CtrlShiftP输入Todo Tree: Show Output在输出面板里能看到插件启动时加载的 glob 列表。如果你写的**/dist/**出现在里面说明配置被正确解析。第三步造一个测试用例。在node_modules下随便找个包往它的index.js里加一行// TODO test-ignore保存。等 TodoTree 刷新侧边栏不应该出现这条。然后在src下建个test.js写// TODO test-visible保存后侧边栏应该立刻出现这条。一负一正两个用例都通过才算配置生效。第四步验证 TaoToken 通道。用同一个 Key 发一次请求确认通道没被配置改动影响curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-3-5-sonnet, messages: [{role: user, content: 回复 OK 两个字母}], max_tokens: 10 }返回里带content: OK就说明 Key 和 API 地址都正常。如果这里报 401先别怀疑 TodoTree去控制台确认 Key 状态https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果报模型不存在去模型对话页面确认可用模型名https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。成功结果长这样TodoTree 侧边栏只列出src、app、components下的待办条目数从几千降到几十点击跳转精准落在业务文件。输出面板里能看到 exclude 规则被加载node_modules不在扫描范围内。5. 本篇常见错排查配置写了但没生效。最常见原因是 JSON 语法错误。settings.json里多一个逗号、少一个引号整个文件解析失败VS Code 会静默忽略。打开文件看有没有红色波浪线或者按CtrlShiftP输入Developer: Reload Window重载后看右下角有没有报错提示。excludeGlobs 写了但 node_modules 还在。检查 glob 是不是写成了**/node_modules少了尾部/**。另外确认你改的是用户设置还是工作区设置如果项目里.vscode/settings.json也定义了excludeGlobs它会覆盖用户级配置两边要合并写。includeGlobs 和 excludeGlobs 冲突。如果 include 里写了**/src/**exclude 里又写了**/src/generated/**exclude 优先级更高generated目录会被排除。这个行为是符合预期的但如果你发现某个业务目录没被扫到先检查是不是被某条 exclude 规则误伤了。TaoToken 请求报 401 或 403。先确认环境变量在当前终端会话里能打印出来。VS Code 的集成终端可能没加载你刚写的 shell 配置重启 VS Code 或者手动source一次。如果 Key 确认无误还是 401去控制台看 Key 是否被禁用或额度耗尽。模型名写错导致 404。TaoToken 的模型名要和平台文档一致别自己拼。去模型对话页面发一条测试消息看它实际用的模型标识复制过来用。TodoTree 扫描卡顿。如果项目特别大即使配了 exclude 还是慢把todo-tree.filtering.includeGlobs收窄到只扫src并且关掉todo-tree.general.showActivityBarBadge减少渲染压力。6. 把配置和通道固定下来TodoTree 的忽略配置本质是一份 glob 清单写一次就能长期用。建议把excludeGlobs和includeGlobs放进项目的.vscode/settings.json并提交到版本库这样团队每个人拉下来就是一致的扫描范围不会出现你这边干净、同事那边满屏的情况。TaoToken 这边Key 放环境变量、地址统一用 https://taotoken.net/api 所有工具读同一个来源。需要长期跑编码任务或 Agent 的可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它把调用额度和通道管理放在一起省得每个工具单独配。接入细节查文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 相关的接入说明在https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 。最后留一个实用习惯每次改完settings.json用Todo Tree: Refresh强制重扫一次再打开输出面板扫一眼加载的 glob 列表。这个动作花不了十秒但能帮你确认配置真的被解析了而不是改了个寂寞。