GoLand 通过启用 Custom folding regions 并配置 //go:region 和 //go:endregion 标记可实现手动代码折叠，需重载项目生效，且标记须独占一行；快捷键需先手动折叠注册区域，structural folding 必须开启以支持嵌套结构独立折叠。
用 //go:region 和 //go:endregion 手动划出折叠块
GoLand 本身不原生支持 Go 的 //go:region，但可通过启用「自定义折叠注释」让它识别。这不是语言特性，而是 IDE 的解析规则——只要配置对，就能把任意逻辑段收起来，且不影响编译。
操作步骤：
- 打开
Settings/Preferences → Editor → General → Code Folding - 勾选
Custom folding regions（不是「Region comments」，那个是旧版选项） - 确认下方的
Start marker填的是//go:region，End marker是//go:endregion - 改完后需重载项目（
File → Reload project from disk），否则已有文件不生效
注意：标记必须独占一行，末尾不能带空格或注释内容；//go:region User Auth 中的描述文字会被折叠时显示为标签，但不能含引号或括号，否则可能解析失败。
为什么 Ctrl+Shift+- 对 region 不起作用？
快捷键 Ctrl+Shift+-（Win/Linux）或 Cmd+Shift+-（macOS）默认只作用于 IDE 自动识别的语法块（如函数、import、if 块），它不响应 //go:region 区域——除非你先手动触发一次折叠。
解决办法只有两个：
- 把光标放在
//go:region行，右键 →Fold Selection（或按Ctrl+.→ 选 Fold Selection） - 用命令面板（
Ctrl+Shift+A）搜Fold Region，执行一次，之后该 region 就能被快捷键联动控制了
别指望第一次写完 //go:region 就能直接按快捷键收起——GoLand 需要先“注册”这个区域，本质是缓存了一次 AST 节点映射。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
region 折叠和结构性折叠（func/if）混用时的优先级问题
当一个 //go:region 块里嵌套了函数或 for 循环，折叠行为会分层：region 是最外层容器，内部的 func/if 仍可独立展开/收起。但容易踩的坑是——误关了 Structural folding，导致 region 能折，但里面的函数却展不开。
检查点：
-
Code Folding设置里，Structural folding必须勾选（它控制func、type、if等大括号块） -
Imports和Comments可按需开关，但别关Structural folding，否则 region 内部逻辑会变成“黑盒” - 如果 region 展开后，里面某个
func无法再单独折叠，大概率是 Structural folding 被关了，而不是 region 配置错了
region 名称怎么写才不容易翻车？
region 标签只是视觉提示，但写法会影响可维护性。实际协作中，多人共用同一份折叠结构时，混乱的命名会让别人不敢动、不敢展开。
建议规则：
- 用业务语义，不用技术动作：
//go:region Payment Validation✅，//go:region Check Stuff❌ - 避免长名拼接：
//go:region HandleUserLoginAndRedirectIfSuccess过长，折叠箭头会截断，建议缩成//go:region Login Flow - 禁止在 region 内部再嵌套 region——GoLand 不报错，但折叠状态会错乱，比如外层收起后内层仍显示展开图标
- region 块之间留空行，否则相邻 region 可能被合并识别为一个折叠单元
真正难的不是配 region，而是判断哪段逻辑值得被折叠：高频修改的校验逻辑不该收，而稳定不变的初始化配置块才适合用 region 封装。折叠不是为了“看起来短”，而是为了让人一眼看清主干路径在哪。
