LazyVim 入门与配置说明

这组文档基于 LongwayBai/lazyvim-config 整理。

我写这组文档，不是想再做一份“LazyVim 有哪些插件”的清单，而是想把这套自己一直在用的配置讲明白：它适合谁、应该先看哪页、和默认 LazyVim 到底差在哪。

图：启动后的仪表盘。对我来说，它的意义不在于好看，而在于刚打开编辑器时就能立刻看到最近处理的文件和常用入口，不用停下来想接下来该干什么。

你可以先看哪几页

• 安装与环境准备：适合第一次装，或者准备把旧配置迁过来时看
• 快捷键速查：适合已经装好了，但一时还记不住按键的时候翻
• 插件与扩展：适合想知道这套配置为什么这样选插件，以及后面该从哪里改起

如果你想直接动手，可以先看 安装与环境准备。如果你已经装好了，只是记不住按键，那就去翻 快捷键速查。如果你想先弄清楚我为什么会一直把它留着，那就继续往下看。

为什么我最后留在这套配置上

我自己最后留在 LazyVim，不是因为它插件多，而是因为它在两个方向上平衡得挺好：

1. 保留了我想要的那种纯键盘驱动效率。
2. LSP、搜索、文件管理这些基础设施，它又提前帮我接好了。

换句话说，这套配置不是为了“把编辑器塞满”，而是为了少折腾一点基础设施，把时间留给写代码、改文档和日常工作本身。

谁会喜欢这套配置

适合谁

这套配置不是给所有人的。如果你符合下面的描述，它可能正适合你。

它比较适合这类开发者：

• 不想从零开始写 Lua，但又觉得默认配置差点意思。
• 习惯键盘工作，希望编辑、搜索、跳转能连成一套动作。
• 需要在本地、远程服务器或容器里有一致的体验。
• 经常写代码，也顺手改 Markdown 或看日志，不想为此切工具。

建议先理解这 4 点

先接受，再理解

刚开始用这套配置时，没必要记住所有功能，先接受这四个设定就够了。用一段时间之后，自然会理解背后的逻辑。

刚开始用这套配置时，没必要记住所有功能，先接受这四个设定就够了：

1. Leader 键是空格。绝大多数快捷键都是“先按空格，再接后续”。
2. 不用太依赖侧边栏。找文件和切目录更多是用搜索和 Yazi 完成的。
3. LSP 已经接好了。跳转、悬浮文档、代码格式化，装好基本就能用。
4. Markdown 是核心能力。专门调优了渲染和预览，写文档时不需要切出去。

我重点改了哪些地方

和“默认版”相比，这几件事是我比较在意的：

• 引入 Yazi 负责文件管理：查文件、切目录、看预览比单纯的树状图顺手得多。
• 调优了 LSP 交互：悬浮文档和代码操作这些高频动作，界面读起来更清晰。
• 增强了 Markdown 体验：实时渲染和浏览器预览都在，写文档不用再找专门的编辑器。
• 配色保持克制：默认是 Catppuccin Frappé，长时间看代码眼睛不累。

如果你安装卡住了，去看 安装与环境准备；如果装好了但不知道按什么，看 快捷键速查。