如何在 Vim 中高效折叠 Go 语言中的错误检查块

本文介绍一种简洁高效的 vim 命令，用于批量折叠 go 代码中常见的 `if err != nil { ... }` 错误处理块，提升源码可读性与导航效率。

在 Go 开发中，遵循“error early,

error often”原则，导致大量类似如下结构的错误检查代码：

if err != nil {
    return err
}

这类重复性代码块虽必要，但在浏览主逻辑时容易造成视觉干扰。Vim 的折叠（folding）功能可有效隐藏它们，而手动为每个块创建折叠过于低效。推荐使用以下一键命令实现批量折叠：

:g/\s*if err /normal jva{zf

命令解析：

• :g/.../ —— 全局匹配符合正则的行；
• \s*if err —— 匹配以任意空白字符开头、后接 if err（注意末尾空格，避免误匹配 errStr 等变量名）；
• normal jva{zf —— 对每行执行普通模式操作：
  • j 向下移动一行（跳至 { 所在行），
  • va{ 可视化选择整个 {...} 代码块（含花括号），
  • zf 创建折叠。

✅ 适用前提：

• Go 代码采用标准格式（如 go fmt 处理过），确保 if err != nil { 与 { 在同一行或下一行对齐；
• if err 后需有空格（如 if err!=nil{ 不匹配，建议统一写法为 if err != nil {）。

⚠️ 注意事项：

• 该命令仅对当前缓冲区生效，如需持久化，可将其封装为自定义命令或映射到快捷键（例如 nnoremap fe :g/\s*if err /normal jva{zf）；
• 若存在嵌套 if err 或复杂条件（如 if err != nil && !isOptional()），正则可能失效，建议优先保持错误检查简洁直白；
• 折叠后可用 za 切换展开/收起，zR 彻底清除所有折叠。

掌握此技巧后，你能在秒级内收起数十处错误处理逻辑，聚焦业务主干，显著提升大型 Go 项目中的代码扫描与维护效率。