Neovim 使用折叠

2024 年 7 月刚入坑 Vim 时，在 Vim 中曾经短暂尝试过「折叠」功能。因为比较少场景使用 Markdown 处理大文件、长文件，很多关于「折叠」的功能不用就忘记了。

最近看到一个 YouTube 博主在介绍 Neovim 中的折叠功能，发现折叠已经内置于 Vim 和 Neovim，新菜上手无需额外插件或配置。但还是需要快速地学习一下相关命令，才能正常使用「折叠」。

• 官方文档：https://neovim.io/doc/user/fold.html#fold-commands
• Vim 和 Neovim 均已经默认 foldmethod 为 manual，运行 :set foldmethod? 可以得到 foldmethod=manual
• 在 Markdown 文档中，可以先简单尝试默认的 manual 方式
• 使用 Vim 的话，在 ~/.vimrc 中，可以手动 set foldmethod=marker 切换折叠方式
• 后续在代码文件中，可以再尝试 indent 方式，需要在配置文件 options.lua 内显式更改配置
• 关于折叠的命令大都由 z 引导，Neovim 配置了 which-key 插件后，按下引导键 z 之后，会显示全部可用命令的提示菜单

创建折叠

并非必须在一个定义域符号内（比如括号），完全无关的两行也能折叠。

• zf{motion} / {Visual}zf
• {count}zF
• :{range}fo[ld]

比如，zf7j 就可将“当前行 + 往下 7 行”这个区域一下折叠起来。折叠区域在甫一创建，即呈「关闭」状态。

打开折叠

• zo: 打开光标处的折叠
• zO: 递归地打开光标处的所有折叠
• zv: 一直打开折叠直到光标处能显示
• :{range}foldo[pen][!]:
  • 打开 {range} 范围内一个等级的折叠
  • 如果使用 !，则打开范围内的所有折叠
• zn: 重置 foldenable，打开所有折叠
• zN: 设置 foldenable，所有折叠恢复到原来的状态
• zi: 倒置 foldenable

关闭折叠

处于「打开」状态的折叠区域，可以通过 zc 或 zC 进行关闭。

• zc:
  • 关闭光标处的折
  • 有嵌套时，仅关闭光标所在处最内层的折叠
• zC: 递归地关闭光标处的所有折叠
• :{range}foldc[lose][!]:
  • 关闭 {range} 范围内一个等级的折叠
  • 如果使用 !，则关闭范围内的所有折叠

开关折叠

切换折叠区域的「打开」和「关闭」状态。

• 小于 foldminlines 所设置的行（默认值是 1）将始终显示
• 关闭折叠将设置 foldenable
• foldenable fen: 当值为 off 时，所有折叠将被打开，默认值为 on

---

• za: 开关光标处的折叠
• zA: 递归地开关光标处的所有折叠

删除折叠

• zd：
  • 删除光标处的折叠
  • 有嵌套时，删除外层折叠，内层折叠将上浮一个等级
  • 光标在内层折叠处执行删除，则不影响外层
  • 有删除比预期更多的折叠的风险
• zD: 递归地删除光标处的所有折叠
• zE: 删除当前窗口中的所有折叠

不熟练

• zx: 撤销手动打开或关闭的折叠
• zX: 递归地撤销手动打开或关闭的折叠
• zm: 从 foldlevel 减去 v:count1
• zM: 关闭所有折叠，并将 foldlevel 设为 0
• zr: 将 v:count1 加入 foldlevel
• zR: 打开所有折叠，设置 foldlevel 为最高等级

在折叠处移动

• [z: 移动到折叠的开始处
• ]z: 移动到折叠的结束处
• zj: 移动到下一个折叠的开始处
• zk: 移动到上一个折叠的关闭处