goland中无统一注释切换键：ctrl+/仅切换单行//注释，ctrl+shift+/才包裹/删除/ /块注释；后者在函数上方空行会误生成/* /文档注释，且非连续选区将导致失效。
GoLand 里没有统一的“一键切换单/多行注释”快捷键，必须按场景选对组合键，否则容易误操作或生成错误格式。
Ctrl+/ 是单行注释，不是块注释
选中多行代码后按 Ctrl+/（Windows/Linux）或 Cmd+/（macOS），只会给每行加 //，不会生成 /* */。这不是 bug，是设计行为——它只做行级注释切换。
- 适合临时屏蔽几行调试语句、条件判断分支等线性逻辑
- 若已有部分行被
//注释，再次执行会取消注释，但不会影响已存在的/* */ - 在字符串或正则内部按此键无反应（IDE 会跳过语法敏感区域）
Ctrl+Shift+/ 才是真正的块注释包裹键
要生成或移除 /* */ 块注释，必须用 Ctrl+Shift+/（Windows/Linux）或 Cmd+Shift+/（macOS）——且必须选中连续的代码块。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 选中后执行：自动包裹为
/* ... */，并保留原有缩进对齐 - 再次执行同一选区：直接删掉外层
/*和*/，不破坏内部换行和空格 - 光标在行内未选中任何内容时，会插入空的
/* */，光标停在中间，适合手写说明 - 若在函数声明正上方空行触发，可能误生成
/** */文档注释（见下一条）
为什么有时 Ctrl+Shift+/ 冒出 /** */？
这是 GoLand 的文档注释模板在起作用——它检测到光标位于导出函数、结构体或变量声明的正上方空行，就优先生成可被 go doc 解析的 /** */。
- 解决办法：把光标移到具体代码行内部再选中，比如移到
if行、for行或某条赋值语句上 - 或临时禁用：进入
Settings → Editor → General → Smart Keys → Go，关掉Insert documentation comment stub - 注意：
/** */和/* */都是合法注释，但混用易让协作者误解为“这是正式文档”，实际只是临时逻辑屏蔽
嵌套逻辑块里手动写 /* */ 极易翻车
超过 5 行的 if/for/switch 嵌套块，千万别手动敲 /* 和 */——Go 不支持嵌套块注释，且字符串、正则里的 / 或 * 可能干扰解析边界。
- 例如：
/* if x > 0 { /* inner */ } */直接编译失败：unexpected /* - 又如：字符串字面量里含
*/（哪怕只是想匹配字面量），会导致注释提前闭合，后续代码被静默注释掉 - 正则表达式如
`/a.*b/`没问题，但若写成`/*`，必须改用原始字符串``或双引号避免歧义 - 结论：复杂逻辑块一律用
Ctrl+Shift+/包裹，别省那两秒手敲
真正容易被忽略的是：快捷键是否生效，取决于光标位置和选区连续性——非连续多选（Ctrl+鼠标点选）会直接让 Ctrl+Shift+/ 失效，而 IDE 不报错也不提示。
