goland 的 todo 标记仅为 ide 内部注释高亮与索引工具,需用标准 go 注释语法+预设关键词(如 todo、fixme),支持自定义模式、快捷查看跳转及手动刷新索引,但不存数据、不替代任务管理系统。

GoLand 的 TODO 标记不是待办应用,它不存数据、不跨机器、不支持命令行操作——它只是 IDE 内部的行级注释高亮和索引工具,用对了能帮你盯住代码里没处理完的点,用错了会误以为自己在做任务管理。
TODO 注释怎么写才被 GoLand 识别
必须用 Go 的标准单行或块注释语法,且内容里包含预设关键词(默认是 TODO 和 FIXME,不区分大小写):
-
// TODO add validation for email field✅ -
/* FIXME: this panic should be handled */✅ -
// todo refactor this handler✅(小写也识别) -
// need to handle error❌(没关键词,不识别) -
//TODO: no space after // —— 大部分版本不识别❌(GoLand 要求//后至少一个空格)
别在字符串字面量或变量名里写 TODO——比如 msg := "TODO: fix this",GoLand 不会索引这种“假 TODO”。
怎么快速查看和跳转所有 TODO 项
按 Ctrl+Shift+T(Windows/Linux)或 Cmd+Shift+T(macOS)直接打开 TODO 工具窗口,里面列出当前项目里所有匹配的注释行。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 双击某条目,光标立刻跳到对应代码行
- 右键支持
Jump to Source(重复跳转)和Remove from TODO List(仅从列表移除,不删注释) - 窗口顶部可切过滤范围:
All Places(整个项目)、Current File(仅当前文件)、Custom Scope(比如只看 test 文件) - 如果没看到任何条目,先检查是否启用了扫描:Settings → Editor → TODO → 确保勾选了
Enable TODO
如何自定义 TODO 模式(比如加 HACK 或 REVIEW)
默认只有 TODO 和 FIXME,但你可以加自己的关键词,比如团队约定用 REVIEW 标记需结对评审的代码:
- Settings → Editor → TODO → 点右下角
+号 - Pattern 填
REVIEW(纯文本,不用写//) - 配颜色(比如橙色)和背景高亮,方便一眼区分
- 勾选
Case sensitive如果需要严格匹配大小写 - 改完后已有
// REVIEW check concurrency safety会立刻出现在 TODO 窗口里
注意:自定义模式只影响显示和索引,不会改变注释语义——它仍是普通注释,不会自动导出、提醒或同步。
为什么改了代码,TODO 窗口里还留着旧条目
GoLand 的 TODO 索引不是实时刷新的,尤其在大项目里可能延迟几秒;更常见的是你删了注释但没触发重索引:
- 手动强制刷新:TODO 窗口右上角点
Refresh图标(循环箭头) - 删掉注释后,如果那行还残留空格或制表符,GoLand 可能仍把它当有效 TODO 行——删干净整行再保存
- 如果用了自定义正则模式(比如
TODO\(.*?\)),括号没闭合会导致整块注释失效,但旧索引还在缓存里 - 最彻底办法:
File → Invalidate Caches and Restart → Invalidate and Restart,清空全部索引重建
别指望它替代真正的任务跟踪系统——它连“已解决”状态都不记录,关掉窗口就等于“视而不见”。真正要跟进的事,该建 issue 就建 issue,该写进 .todo.json 就写进文件。










