GoLand支持三种代码标记方式:TODO注释(如// TODO:)自动聚合至TODO窗口;F11快捷键创建临时书签,仅存于IDE内存;Live Template插入结构化注释块(如// MARK:),便于全局搜索。

用 TODO 注释自动标记关键代码
GoLand 会把以 TODO、FIXME、XXX 开头的行内注释识别为任务标记,并在侧边栏和全局搜索中聚合显示。这不是手动加书签,而是靠语义识别实现的“可检索标记”。
- 写法必须严格:开头是大写
TODO,后面紧跟冒号或空格,例如// TODO: 需要重构缓存逻辑或// FIXME handle nil pointer - 不支持小写
todo或带括号的变体(如// (TODO)),IDE 默认只匹配预设关键词 - 标记会实时出现在 TODO 工具窗口(快捷键
Alt+6),双击可跳转到对应行 - 如果项目里已有自定义关键词(比如
REVIEW),需在Settings | Editor | TODO中手动添加并配置高亮颜色
临时书签:用 F11 快速打点再跳转
当你要反复回到某几行调试或对比时,F11 是最轻量的本地标记方式——它不依赖注释,也不写入文件,纯 IDE 内存态记录。
- 光标停在目标行,按
F11打一个匿名书签;再按一次取消 - 所有书签统一收在 Bookmarks 工具窗口(
Alt+2),默认按文件分组,点击直接跳转 - 若想区分优先级,可在打标后按
Ctrl+Shift+Num(如Ctrl+Shift+1)分配数字书签,之后用Ctrl+Num直达 - 注意:书签不会被 Git 跟踪,换机器或重装 IDE 后丢失,仅适合短期高频访问场景
结构化标记:用 Live Template 插入带上下文的注释块
单纯写 // TODO 容易遗漏背景信息。用 Live Template 可一键插入含作者、时间、模块名的标准化标记,避免后续看不懂自己当初为什么标这儿。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在
Settings | Editor | Live Templates中新建模板,缩写设为mark,模板文本为:// MARK: ${USER} ${DATE} — ${DESCRIPTION} - 设置适用范围为
Go,勾选Reformat according to style - 编辑时输入
mark+Tab,自动展开并高亮${DESCRIPTION}区域,补上简短说明(如并发安全待验证) - 这类标记虽不会进 TODO 窗口,但能通过
Ctrl+Shift+F全局搜MARK:快速定位
别踩坑:标记失效的常见原因
标记功能看似简单,但实际常因配置或习惯问题失效,尤其在多人协作项目里。
-
TODO不显示?检查是否禁用了检查:进入Settings | Editor | Inspections,确认General | TODO已启用 - 书签突然没了?可能是启用了
Settings | Appearance & Behavior | System Settings | Synchronize files on frame activation,导致 IDE 重载时清空临时状态 - Live Template 不生效?确保模板作用域选对了语言——Go 文件里选
Go,别误选成Go template或Text - 所有标记都查不到?先确认当前文件没被排除在项目索引外:右键文件 →
Reload project,或检查.idea/misc.xml是否有意外 exclude 规则
真正难的不是打标记,而是让标记在两周后、换人接手时依然能被准确理解。所以优先用 TODO + 明确动词(如 refactor、verify、remove after v2.3),比写“这里要注意”有用得多。

















