<p>GoLand注释自动换行需同时启用“Wrap when typing”和“Right margin”，仅对//单行注释生效，/ /块注释不支持；建议右边界设120列，并配置Continuation indent为4以确保缩进正确。</p>
GoLand里注释不自动换行？不是bug，是没开「Wrap when typing」
GoLand 默认不会在你写注释时自动折行，哪怕你已经设了右边界。关键开关藏在「Code Style → Go → Wrapping and Braces」里，且必须同时启用两个选项才生效：一是 Wrap when typing，二是 Right margin (columns)（比如设为100）。只设右边界数值但关掉自动换行，敲到第101个字符时它真的一点反应都没有。
常见误操作：
- 只在
General → Editor → Appearance里勾了Show right margin—— 这只是画条线，不触发换行 - 在
Code Style → Go → Blank Lines里调空行数 —— 和注释折行完全无关 - 把
Right margin设成 80，但Wrap when typing是灰色不可选 —— 通常因为当前 Scheme 不是 Project 级别，需点右上角齿轮选Copy to Project
注释换行只作用于 // 行注释，/* */ 块注释不受控
GoLand 的自动换行逻辑只识别以 // 开头的单行注释。你在函数上方写的结构化文档注释（即 // User represents... 这种）会被处理；但用 /* ... */ 包裹的任意注释块，无论多长，都不会被自动拆行 —— IDE 直接跳过。
原因很实际：Go 官方工具链（gofmt、go doc）只解析 // 注释，/* */ 被视为普通注释文本，不参与文档生成。GoLand 遵循这一语义，不做额外干预。
所以如果你看到某段 /* */ 写得超长又不折行，别折腾设置，要么改用 //，要么手动加换行符。
右边界值设多少？建议和团队 linter 对齐，别迷信 80
Go 社区主流接受 100–120 字符宽度，revive 等 linter 默认警告阈值是 120，gofmt 本身不限制但输出倾向紧凑。硬套 Python 的 80 字符会频繁打断中文注释或带泛型签名的函数说明。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
实操建议：
- 打开
Settings → Editor → Code Style → Go → Wrapping and Braces - 把
Right margin (columns)设为120（不是 80） - 确保
Comment at line start和Comment at function end下的Wrap on typing都已勾选 - 测试：在函数上方敲
//后连续输入超 120 字符的中文+英文混合描述，看是否在空格处自动断行
换行后缩进错乱？检查「Continuation indent」设置
自动换行后的第二行注释，如果缩进不对（比如顶到行首或缩进太多），问题大概率出在 Continuation indent 值上。这个值定义“续行”该缩进多少空格，和普通代码缩进（Indent）是分开控制的。
典型症状：
- 第一行注释正常缩进 4 空格，第二行变成 0 或 8 空格
- 换行后光标停在错误列，导致后续输入偏移
解决方法：
- 进入
Settings → Editor → Code Style → Go → Tabs and Indents - 找到
Continuation indent，设为4（与主缩进一致） - 取消勾选
Use tab character，避免混用 tab/spaces 导致对齐失效
这个值容易被忽略，但它决定换行后那行注释的视觉归属感——缩进不对，读起来就像两段无关文字。
