Treesitter on Yang's Notes

与 AI 的 Neovim 现代化折腾纪实 (2026版)

yang@yhu.me (Yang Hu) — Mon, 06 Apr 2026 22:30:00 +0800

太久没写代码，重拾 Neovim 时发现不仅肌肉记忆有些生疏，而且因为插件生态的“疯狂内卷”，原来的配置报出了一连串的错误。于是和 AI 结结实实地“折腾”了一番，完成了一次 Neovim 架构的现代化升级。

这篇博客是我和 AI 聊天复盘的摘要记录，方便以后如果又断档了，可以快速接上思路。

1. 认知转换：从“极客生存手册”到“现代 IDE”
#

在重新梳理快捷键和工作流时，AI 敏锐地指出我之前的旧文档思维还停留在原生 Vim 时代。而我现在的配置，其实已经是一个极其现代化的 IDE，工具其实在主动配合直觉：

搜索与查找：从敲命令退化到了全屏互动（全面拥抱 fzf-lua，支持代码预览和悬浮窗）。
精准跳转：不再依赖盲按 j/k 或者原生的标记，而是依靠视觉反馈的 Leap (s 瞬移) 和 Flash (S 语法树节点选择)。
多文件管理：用 Grapple (<leader>ma 打标, <leader>n 轮切) 替代了需要心智负担的数字 Buffer 管理，只把核心文件钉在书签里。
大纲与排错：用 Trouble 和 Aerial 侧边栏替代了底部的纯文本 Quickfix 列表。

2. 踩坑纪实：Treesitter 0.10+ 断代大迁移
#

这次遇到了 Neovim 社区目前最大的一个“断层更新”巨坑。因为我使用了 Neovim 0.12.0，核心 API 的变化导致了连环爆炸：