01 lazy.nvim 架构

kickstart.nvim 内置了 lazy.nvim，你已经体验过它自动安装插件的过程。现在深入理解它的工作原理，才能从"用别人的配置"过渡到"写自己的配置"。

lazy.nvim 的核心设计：所有插件声明为一个 Lua table 数组，lazy.nvim 负责下载、缓存、编译字节码、按需加载。你只需要告诉它"要装什么"和"什么时候加载"，剩下的事它全包了。

这段引导代码只在首次运行时执行——检测到 lazy.nvim 不存在就从 GitHub 克隆，之后直接加载。这是"自举"模式，让插件管理器自己管理自己的安装。

02 spec 结构与懒加载

每个插件在 setup() 中用一个 spec table 声明。spec 的核心字段：

懒加载是 lazy.nvim 的灵魂——只在需要时才加载插件，而不是启动时全部加载。常见触发方式：

opts vs config：当插件有标准的 .setup() 接口时，用 opts 传参即可，lazy.nvim 自动调用 require(插件名).setup(opts)。需要更灵活的逻辑时用 config 函数——但两者不能同时使用。

03 which-key 键位提示

当你按下 <leader> 后等待一秒，which-key 会弹出一个面板，列出所有可用的快捷键组合及其描述。你再也不用死记快捷键——按一个键就能看到后续选项。

which-key 的工作原理是扫描所有 vim.keymap.set 中设置了 desc 字段的映射。所以你在上一篇写的 desc = "保存文件" 会被 which-key 自动拾取并显示。

event = "VeryLazy" 是 lazy.nvim 的一个特殊事件，在所有立即加载的插件完成后触发。which-key 不需要太早加载，因为用户按键前它无用武之地。

04 编辑效率插件组

这一组插件直接提升编辑效率——每一次按键节省一秒，一天积累下来就是几十分钟。

上一篇你学了 ci"（改引号内文字）。nvim-surround 把这种能力扩展到"添加、删除、替换配对符"：

用 gcc 注释当前行，gc3j 注释当前行和下面 3 行，Visual 模式选后 gc 注释选中区域。插件会自动识别文件类型并使用对应注释符（Python 用 #，Lua 用 --，C 用 /* */）。

在代码缩进位置显示竖线，让你一眼看清嵌套层级。配合 listchars 选项，空格和 Tab 的区别也一目了然。

这三个插件的 spec 声明都很简洁：

version = "*" 表示用最新稳定版而非 main 分支。main = "ibl" 告诉 lazy.nvim 插件的入口模块名（indent-blankline v3 把模块名从 indent_blankline 改成了 ibl）。

05 视觉增强插件组

视觉插件提升的不是功能，而是"看得清楚"——状态栏信息、颜色高亮、TODO 标注。它们让你不需要敲命令就能获取上下文。

底部状态栏显示当前模式、文件名、行列号、文件类型、Git 分支。lualine 用 Lua 配置，可以自定义每个 section 显示什么：

dependencies 声明依赖插件——lualine 需要文件类型图标，所以依赖 nvim-web-devicons。lazy.nvim 会自动先安装依赖再加载主插件。

在 CSS / HTML 文件中，#ff6600 这样的颜色值会被背景色高亮——直接看到颜色长什么样。对前端开发非常实用。

在代码中写了 -- TODO: 处理边界情况 或 // FIXME: 内存泄漏 时，todo-comments 会高亮这些关键词，并在 quickfix 列表中汇总所有 TODO 项——一眼掌握项目里还有哪些活没干完。