我创建了一个 VS Code 扩展,将 TODO 转换为 Kanban 看板并在 Jira 中生成真实的 issue
发布: (2026年1月9日 GMT+8 14:04)
4 min read
原文: Dev.to
Source: Dev.to

代码中经常会出现大量 TODO。
而团队也知道,这些大多数永远不会真正变成工作任务。
它们埋在注释里,被遗忘,逐渐演变成看不见的技术债务。
问题
在大多数项目中,技术债务散落在代码注释里,例如:
// TODO: refatorar isso
// FIXME: tratar edge case
// NOTE: melhorar performance
这些都是实际的待办事项,但它们不在 Jira 中,未进入冲刺,缺乏优先级,通常也没有负责人。
换句话说:待办列表并未真实反映代码的实际情况。
思路
如果把 TODO 当作真正的待办事项来处理会怎样?
TODO Board 是一个 VS Code 扩展,它:
- 扫描项目并找到
TODO、FIXME、NOTE等标记 - 在编辑器内部以看板(Kanban)形式组织所有标记,支持搜索、标签、按文本和日期过滤
- 只需一次点击即可将任意 TODO 转换为 Jira 中的 issue,无需复制粘贴,也不会丢失上下文
扩展功能
- 扫描项目寻找
TODO、FIXME、NOTE… - 在 VS Code 中以看板形式展示所有结果
- 显示文件、行号、年龄和优先级
- 直接在编辑器中创建 Jira issue
- 自动填充 issue 的代码上下文
- 在重新扫描时保持 TODO ↔ issue 的关联
- 支持添加标签和优先级

配置
TODO Board 允许你完全自定义扫描器在项目中的行为。
文件扩展名
"todo-board.fileExtensions": [
"ts", "tsx", "js", "jsx", "vue", "py", "go", "rb", "php", "rs", "swift"
]
搜索模式
"todo-board.searchPatterns": ["@TODO", "FIXME", "BUG"]
每个 TODO 的最大行数
"todo-board.maxTodoLines": 4
可视化高亮
"todo-board.highlight.enabled": true,
"todo-board.highlight.highPriorityColor": "#e74c3c",
"todo-board.highlight.mediumPriorityColor": "#ffa94d",
"todo-board.highlight.lowPriorityColor": "#4dabf7"
与 Jira 的正确集成
集成使用 OAuth 2.0(3LO)和安全的后端,具体如下:
- 扩展本身不直接调用 Jira API。
- 所有通信都通过后端进行。
- 令牌以安全方式存储。
- 应用仅请求最小必要权限。
- 用户只能在自己有权限的项目中创建 issue。

为什么有用
- 技术债务变得可视化。
- 待办列表真实反映代码现状。
- 规划更具可预见性。
- 减少被遗忘的 TODO。
- 降低返工率。
你的代码终于可以和待办列表“对话”了。
开源
该项目已开源,地址如下:
- GitHub:
- 官方 Marketplace 上的扩展:
欢迎提交反馈、issue 和 PR 🙂