空启动时,欢迎页显示 3/25 modules | 7 ms。一旦以 nvim file.lua 启动,编辑器要识别文件类型、挂上语法高亮,还得在合适的时机启动语言服务器。两次启动走的是不同路径,欢迎页的数字只覆盖其中一段。把它当成“编辑器多少毫秒可用”,会漏掉这份配置最值得研究的东西:谁依赖谁,哪项工作必须在事件发生前完成,哪项工作可以推给第一次交互。
本文分析 DefectingCat/nvim 的 3e917ea 快照,实测环境为 Apple M4、Neovim 0.12.6;插件、语言解析器和测试用格式化器均已安装。它不是一份插件推荐清单,也不拿本机数据和别人的配置排名。
vim.pack 管包,不替你决定功能何时可用
init.lua 打开 Lua 加载缓存,设置选项、键位和自动命令,再进入 lua/pack.lua,最后应用 clay。这个顺序让〈空格〉Leader 在映射创建前就生效,也让主题在执行 :colorscheme 前已可见。实验性 vim._core.ui2 则由 pcall 保护,避免一个内部接口的变化阻断整份配置。
插件有三种容易混淆的状态:已登记、运行时可见、功能已初始化。vim.pack 负责第一层;runtimepath 及 :packadd 决定第二层;仓库的 lua/lazy.lua 用 _loaded 记录第三层。查看 vim.pack.get() 的 active 并不能知道某个插件的 setup() 是否已跑过。
clay.nvim和mini.nvim以{ load = false }登记。这里的false按 Neovim 0.12.6 的:help vim.pack.add()走类似:packadd!的路径,不是把包藏起来;mini.starter与mini.notify已可require,mini.pick仍可等到按键才初始化。- 其他包使用一个空
load回调:vim.pack仍处理登记及必要的安装,但回调不把它们加入运行时。各功能入口之后才决定何时:packadd。在实测的空会话里,md-render.nvim已安装且active,nvim_get_runtime_file('plugin/md-render.lua', false)仍查不到入口;mini.pick的 Lua 文件则已能查到,模块尚未加载。
这种分工也解释了为什么首次安装并不懒:vim.pack.add() 要等缺失的包安装完成才返回。另一个边界是可复现性:仓库忽略 nvim-pack-lock.json。本机有锁,换机器仅靠 Git 上的配置快照却拿不到同一组插件提交;Mason 工具和已编译的 parser 还各自有版本。个人机器更新方便,长期复现则需要另外保存这些状态。
首文件:把硬前置留在启动,把其余开销移到事件之后
nvim-treesitter/main 是少数明确在启动期间 packadd 的包。上游把 parser 管理和 queries 放在一起,并明确不支持懒加载;首个文件需要解析和高亮时,不能还在等待运行时资料就位。配置把激活插件、给 buffer 开高亮、检查缺失 parser拆开:启动激活插件,FileType 尝试挂高亮,100 ms 后用 parser/<lang>.so 的运行时查询筛出缺失项,只把缺失项交给安装器。PackChanged 也只在 Treesitter 包的变更类型是 update 时调度 parser 更新。升级后等这项异步任务完成再重启;也可单独执行 :TSUpdate。实现
同一棵树不必同时服务所有界面功能。语法高亮按 buffer 启动;Treesitter 折叠则按窗口延迟启用。我在一个已高亮的 Lua 文件中按下 za,foldmethod 才从 manual 切换到 expr。这条路径不会覆盖已有的自定义 foldexpr,分屏也会沿用来源窗口的初始化状态。打开文件只读不折叠,就不必为首屏先算折叠结构。实现
LSP 先发现工具,再由原生客户端匹配 buffer
LSP 不需要抢在首个 FileType 前完成初始化。pack.lua 遇到普通 buffer 的首个 FileType,若还未经过 VimEnter,就把初始化排到调度队列;进入编辑器后的首次匹配则直接初始化。空启动也保留 :Mason 等命令入口。这里还有一处防重入:vim.lsp.enable() 会对已有 buffer 重新触发 FileType,不能让这个事件递归启动第二轮初始化。
lua/plugins/lsp.lua 读取已安装 Mason 包的 spec.neovim.lspconfig,确认本机的 lsp/<name>.lua 存在,再调用 vim.lsp.enable()。因此安装包名、LSP 配置名、某个 buffer 的实际客户端不是一回事。这个实验里的 Lua buffer 附着了 lua_ls 和 stylua;这不意味着仅在 PATH 上放一个可执行文件就会被扫描,也不意味着装完新包当前进程会重扫。新包要在下次初始化时才进入启用列表,而启用仍不等于附着。
补全有一个反方向的依赖:LSP 初始化请求发出前就要声明补全能力。所以这里允许提前 require('mini.completion') 获取 capabilities,但推迟到 InsertEnter 才执行其 setup(),并回填当前 buffer 的 completefunc。同一个模块,读一份客户端能力数据和接管插入态交互,不必发生在同一时刻。
懒加载的难点,是第一次也必须正确
lazy.load() 只在 setup 成功后置位;失败会通知、保留重试入口,按键入口也不会继续执行依赖插件的动作。我注入了一次失败:第一次没有置位,第二次成功,第三次没有重复运行初始化。这个保证只覆盖标记,不会回滚 setup 失败前已经创建的命令或自动命令。自定义加载器省下了通用框架,不等于消除了这些生命周期责任。
首次保存不能漏掉格式化
Conform 在 BufWritePre 或手动格式化键首次加载。首次 :write 已经在分发 BufWritePre;这时 conform.setup() 注册的新自动命令不会参与同一轮,配置因此在触发入口手动格式化一次,后续写入交给 Conform 的回调。
我对临时 Lua 文件做了四次保存:首次写盘把 local sample={a=1} 改成 local sample = { a = 1 },第二次照常格式化,之后分别关闭 buffer 和全局自动格式化,写盘内容均保留未格式化文本。保存路径使用 500 ms 的超时设置以及 LSP fallback。JS/TS/JSON 族另有项目策略:向上找到 biome.json 或 biome.jsonc 时在 biome-check、biome 中取首个可用工具,否则走 prettierd。这里的分支由项目文件决定,不是 Biome 不可用就自动切换成 Prettier。
首次命令不该换一种语义
Markdown 预览的命令入口没有写一个临时 :MdRender 再自己拼接参数,而是在原生 CmdUndefined 里 packadd,由 Neovim 继续执行原调用。我以 :silent keepalt MdRender tab 第一次调用,真实命令创建了新标签页,源 buffer 的 changedtick 未变。代价也很具体:命令定义之前不能依赖它的补全;而且这里只监听 MdRender,不替上游每个别名冷启动。键位入口则让 〈空格〉tm 在同一次按键中加载并打开预览。
交互工具按工作尺度拆开,而不是按插件分菜单
文件查找、文件树和内容替换是不同操作。〈空格〉ff 用 rg --files --hidden 枚举文件,仍尊重 ignore 规则;〈空格〉fa 显式加 --no-ignore;两者排除 .git/。mini.files 的 - 从当前文件或最近存在的父目录打开,_ 则找 Git 根。文件树里的文本编辑先形成待同步操作;Ctrl-S 只对纯 CREATE 批次自动确认,删除、移动、复制、重命名仍确认。它用的是上游确认文本做判别,升级 mini.nvim 时应专门试一次混合操作,而不是把这层包装当成稳定的结构化 API。


真实终端帧重绘:〈空格〉ff 打开当前仓库的文件候选。
Git 也按工作尺度分。Gitsigns 负责文件里正在看的 hunk;Neogit 用标签页承接暂存、提交、查历史等仓库操作;CodeDiff 承接并排差异和逐文件历史。]h / [h 在 diff 窗口转交原生 ]c / [c,让导航跟随当前视图的差异来源。小细节比插件数量更能体现取舍:mini.clue 自己注册 buffer 局部的前缀触发器,不能像普通功能那样包一层首次按键;LSP 和 Gitsigns 附着、创建局部映射后,配置会重新安装提示触发器。Visual 模式的环绕操作改用 S,则是为了不让普通 y 等待 ys 前缀的超时。
Markdown 预览同样保留两个界面:源 buffer 用于编辑,浮窗、分屏或标签页用于阅读。调整编辑器宽度后,配置以列数的 80% 重新计算浮动预览宽度,并调用插件接口重排可见内容。终端从 108 列缩到 96 列时,可见浮窗变为 76 列,源 buffer 的 changedtick 仍未变。表格、告警块和代码可用普通文本界面查看;图片、视频帧、Mermaid 图像则需要上游支持的 Kitty graphics protocol 路径,Neovide 不提供这部分。这也是为什么预览实现与 GUI 字体、透明度之类的设置应该分别看待。


真实终端帧重绘:背景是源缓冲区,浮窗有自己的排版和页脚。
启动页的数字,为什么不是首屏延迟
mini.starter 页脚 的两个数字测的是不同东西。模块数是生成页脚时 _loaded 中的条目数,分母是手写的 25 个功能模块;不是已安装包数,也不会随后台任务自动刷新。毫秒数固定取 init.lua 入口到应用配色结束的间隔,排除了后续插件扫描、文件打开和 VimEnter,更不可能包含 LSP 初始化握手。--startuptime 的 NVIM STARTED 是另一把尺:这次日志里它在第一次界面更新之后,但它仍不是物理屏幕已经呈现,也不表示语言服务器已就绪。


真实终端帧重绘:欢迎页的模块统计与同步配置段耗时。
本机使用已安装的工具和热缓存,以 headless 模式做空启动和打开同一个临时 Lua 文件各 12 次,交替调整先后顺序,另丢弃两组预热。配置加载前注册首个 VimEnter 回调,在回调入口采样;同一回调安排至少 250 ms 后再采一次。
| 启动方式 | 同步 init.lua 中位数(ms) | NVIM STARTED 中位数(ms) | NVIM STARTED 范围(ms) | 已初始化模块:VimEnter 回调入口 → 延后采样 |
|---|---|---|---|---|
| 空启动 | 9.2 | 20.4 | 14.8–30.5 | 3 → 6 |
| 打开 Lua 文件 | 7.2 | 23.0 | 20.4–39.1 | 6 → 13 |
开文件那组的同步段反而略短,但打开文件发生在这个计时终点之后;两组样本的波动也都不小,不能用其中一列证明新版更快,更不能把两个中位数的差额当成某个插件的耗时。更直接的证据来自状态:两组在 VimEnter 回调入口均未初始化 LSP、Gitsigns;延后采样时,Lua 路径两者均已初始化且有实际的 LSP 客户端,空启动则没有。Gitsigns 已初始化不代表每个文件都已附着,样本文件就在 Git 仓库之外。
要复查自己机器上的时间线,可以在已有插件的环境里对照运行,并看日志尾部的 opening buffers、VimEnter autocommands 和 NVIM STARTED:命令与测量说明。
work=
quit='autocmd VimEnter * ++once lua vim.defer_fn(function() vim.cmd("qa!") end, 250)'
值得保留的判断标准
这份配置最值得借鉴的是给每段工作找最晚而正确的执行点。查询必须早于使用它的首文件;格式化必须早于写盘;没打开文件就不用扫语言服务器;没有按下搜索键,就不用启动 picker。至于是否继续挪动某项工作,判断标准不该只是一行好看的启动数字。先保证首次触发与后续触发行为一致,再分别测空启动、首文件和首次交互。只有这样,才分得清一项工作真的消失了,还是只是被挪到了用户下一次按键之后。


评论
按时间排序