LazyVim 从入门到配置体系学习记录#

总体判断#

LazyVim 不是“帮你省掉学习 Vim 的发行版”，而是把现代 Neovim 插件生态整理成一套可用默认值，让开发者把注意力放回 Vim 的组合式编辑模型。

它解决的核心问题不是“不会配置 Neovim”，而是：现代开发需要 LSP、TreeSitter、picker、Git、formatter、diagnostics、testing、debugging 等大量插件，而 Neovim 原生能力虽然强，但默认体验分散。LazyVim 的价值在于把这些能力组织成一致入口，同时保留 Vim 的编辑语言。

学习 LazyVim 的正确顺序应该是：先学 Vim 的编辑语法，再学 LazyVim 给这些能力配好的入口，最后才学插件配置和扩展。不要一上来研究插件，否则容易陷入“配置娱乐”。

基础心智模型#

Vim 的核心不是快捷键，而是模式切换：

模式	用途
Normal	移动、操作、组合命令
Insert	输入文本
Visual	选择文本
Command	执行命令

常用入口：

1
i   当前光标前插入
2
a   当前光标后插入
3
I   行首插入
4
A   行尾插入
5
o   下方新开一行
6
O   上方新开一行
7
gi  回到上次插入位置
8
Esc 回 Normal

关键理解：Insert mode 只负责输入，Normal mode 才是真正的编辑状态。不要长期停在 Insert mode。

移动体系#

基础移动是 h/j/k/l，但真正应该练的是更高层的语义移动：

1
w / e / b / ge
2
W / E / B / gE
3
0 / ^ / $ / g_
4
gg / G / 100G
5
Ctrl-d / Ctrl-u
6
Ctrl-f / Ctrl-b
7
zt / zz / zb
8
f / F / t / T
9
s
10
Ctrl-o / Ctrl-i

Ctrl-o 和 Ctrl-i 类似浏览器后退/前进。s 来自 Flash.nvim，是 LazyVim 现代化跳转的重要入口。

Vim 编辑语言#

`verb + motion`#

Vim 的第一个核心语法是：

1
<verb><count><motion>

示例：

1
dw      删除一个 word
2
d2w     删除两个 word
3
c$      改到行尾
4
dd      删除整行
5
cc      改整行

常用命令：

1
d{motion}
2
c{motion}
3
D
4
C
5
dd
6
cc
7
x
8
X
9
r<char>
10
J
11
gJ
12
u
13
<C-r>
14
.

. 是 Vim 编辑模型的放大器：先做一次可重复编辑，再用 . 复制动作。

`verb + text object`#

第二个核心语法是：

1
<verb><context><object>

其中：

1
i = inside
2
a = around

常用示例：

1
diw   delete inside word
2
daw   delete around word
3
ci"   change inside quotes
4
da"   delete around quotes
5
di(   delete inside parentheses
6
da(   delete around parentheses

LazyVim 增强对象：

1
caq / ciq   quote object
2
dib / dab   bracket object
3
yig         indent object

Surround 相关：

1
cS
2
dS
3
yS
4
gsa
5
gsd
6
gsr

Text object 是 Vim 真正拉开差距的地方。它让编辑从“手动选择一段文本”变成“对语义对象执行动作”。

文件、搜索和导航#

文件打开#

LazyVim 默认文件入口主要有三种：

工具	用途
Snacks picker	快速搜索文件
Snacks explorer	类似文件树
mini.files	更接近可编辑文件系统 buffer

常用快捷键：

1
<Space><Space>  找文件
2
<Space>ff       find files
3
<Space>e        左侧导航
4
<Space>fm       mini.files

如果工作流以 tmux + Claude Code 为主，文件打开优先练 picker-first：<Space><Space>、<Space>/、<Space>ff，而不是依赖文件树。

搜索#

当前文件搜索：

1
/pattern
2
?pattern
3
n
4
N
5
3n

大小写控制：

1
\C
2
\c
3
:set noignorecase
4
:set ignorecase

项目搜索：

1
<Space>/
2
Alt-s
3
Alt-t
4
[q / ]q

关键区别：/ 使用 Vim regex，<Space>/ 使用 ripgrep regex。

LSP 导航#

常用 LSP 导航：

1
gd       go to definition
2
gr       references
3
K        hover

Symbols：

1
<Space>ss
2
<Space>sS
3
<Space>sR
4
Control-q
5
Alt-t

最重要的组合是：

1
gd
2
Ctrl-o

gd 负责跳进去，Ctrl-o 负责回来。两者必须成对练。

Picker 和 Trouble 的区别：Picker 负责查找、筛选、快速跳转；Trouble 负责保留一组结果并逐项处理。

Buffer、Window、Tab、Session#

LazyVim 中这些概念不能按 VS Code 标签页理解：

概念	正确理解
Buffer	打开的文件内容
Window	一个显示 buffer 的视图/pane
Tab	一组 window 布局
Session	buffers/windows/tabs/layout 的保存

常用 buffer 操作：

1
H / L
2
[b / ]b
3
<Space>,
4
<Space>bd
5
<Space>bD

Window：

1
<Space>wv
2
<Space>ws
3
<Space>|
4
<Space>-
5
Ctrl-h / Ctrl-j / Ctrl-k / Ctrl-l
6
<Space>wq
7
<Space>wc
8
<Space>wo
9
<Space>w<Space>

Session：

1
<Space>qq
2
<Space>qs
3
<Space>qS
4
<Space>qd

对 tmux 用户来说，Neovim window 和 tmux pane 容易重叠。更稳妥的做法是保持 Neovim 内部布局简单，不要同时把两边都复杂化。

语言支持、诊断和格式化#

LazyVim 语言支持不是一个整体系统，而是多个工具的组合：

1
Mason + LSP + TreeSitter + formatter + linter + diagnostics

常用入口：

1
<Space>cm       Mason
2
<Space>cl       LSP info
3
:LspRestart
4
:checkhealth
5
:checkhealth vim.lsp
6
:checkhealth mason
7
:LazyHealth

Diagnostics：

1
[d / ]d
2
[w / ]w
3
[e / ]e
4
<Space>cd

Trouble：

1
<Space>x
2
<Space>xx
3
<Space>xX

Code action / format：

1
<Space>ca
2
<Space>cf

典型 LSP 配置：

1
return {
2
  {
3
    "neovim/nvim-lspconfig",
4
    opts = {
5
      servers = {
6
        -- server config
7
      },
8
    },
9
  },
10
}

典型 formatter 配置：

1
return {
2
  {
3
    "stevearc/conform.nvim",
4
    opts = {
5
      formatters_by_ft = {
6
        typescript = { "prettier" },
7
      },
8
    },
9
  },
10
}

排查问题时不要笼统说“LazyVim 坏了”，要拆成 Mason、LSP、TreeSitter、formatter、linter、diagnostics 分别检查。

搜索替换和批量编辑#

当前文件替换：

1
:s/pattern/replacement
2
:%s/pattern/replacement/g
3
:%s/pattern/replacement/gc
4
:s//replacement/
5
:%sg

项目替换：

1
<Space>sr

rip-substitute：

1
g/

批量 Normal：

1
:%norm commands
2
:<range>norm @q

Global command：

1
:%g/pattern/d
2
:g!/pattern/command

Vim 的批量编辑不只是 search/replace，更强的是“搜索筛选范围 + 对每一行执行 Normal 命令”，也就是 :g 和 :norm 的组合。

Git 工作流#

Git picker：

1
<Space>gs
2
<Tab>
3
<Space>gl
4
:lua Snacks.picker.git_branches()

gitsigns/hunk：

1
<Space>gh
2
[h / ]h
3
<Space>ghS
4
<Space>ghs
5
<Space>ghr
6
<Space>ghR
7
<Space>ghu
8
<Space>ghb
9
<Space>ghp
10
<Space>ghd
11
<Space>ghD

lazygit：

1
<Space>gg

diff：

1
nvim -d file1 file2

1
:diffoff
2
:diffget
3
:diffput
4
do
5
dp
6
[c / ]c

对 Claude Code + CLI 工作流来说，不必把 Git 全搬进编辑器。最值得掌握的是看 hunk、stage/reset hunk、preview hunk 和进入 lazygit。

AI、调试和测试#

AI#

作者对 AI 的判断很现实：AI 很强，但不总是节省时间；AI 出错后的修正成本经常抵消收益。

作者更偏向在独立终端运行 Claude Code、Gemini CLI、Codex，而不是在 LazyVim 内深度集成 AI。

Sidekick.nvim 入口：

1
<Space>a
2
<Space>aa
3
<Space>af
4
<Space>av
5
<Space>at
6
<Space>ap

Copilot Chat 魔法字符：

1
#   添加上下文
2
>   持久上下文/会话级指令
3
$   选择模型
4
/   prompt
5
@   tool

上下文示例：

1
#buffer:active
2
#buffer:visible
3
#selection
4
#url:<url>

对当前 Claude Code + tmux 工作流来说，不建议为了“Neovim 里也能 AI”而装一堆 AI 插件。Claude Code 已经是主力，Neovim 最多需要轻量入口，甚至完全不需要。

Debugging#

DAP 即 Debug Adapter Protocol。LSP 统一编辑器和语言服务，DAP 统一编辑器和调试器。

启用：

1
dap.core
2
lang.python
3
lang.go

调试快捷键：

1
<Space>d
2
<Space>db
3
<Space>da
4
<Space>dc
5
<Space>du
6
<Space>dB
7
<Space>dl
8
<Space>dO
9
<Space>do
10
<Space>di

调试器的真实成本在项目环境，不在编辑器 UI。LazyVim 的 DAP 体验不差，但每个语言、容器、路径映射都会有坑。前端场景下 Chrome DevTools 仍然更自然。

Testing#

核心插件是 Neotest。

启用：

1
test.core
2
lang.python

常用快捷键：

1
<Space>t
2
<Space>tt   当前文件测试
3
<Space>tr   当前测试
4
<Space>tT   全项目测试
5
<Space>ts   summary
6
<Space>tw   watch
7
<Space>td   debug test
8
<Space>to   最近输出浮窗
9
<Space>tO   输出窗口

Vitest adapter 示例：

1
return {
2
  { "marilari88/neotest-vitest" },
3
  {
4
    "nvim-neotest/neotest",
5
    opts = {
6
      adapters = { "neotest-vitest" },
7
    },
8
  },
9
}

Neotest 对 TDD 很有价值，但前提是项目测试框架稳定。JS/TS 不会因为开启 TypeScript Extra 就自动支持 vitest/jest，需要明确选择 adapter。

LazyVim 配置体系#

插件目录：

1
~/.config/nvim/lua/plugins

如果使用 NVIM_APPNAME：

1
~/.config/$NVIM_APPNAME/lua/plugins

单插件：

1
return {
2
  "user/repo",
3
  opts = {},
4
  keys = {},
5
}

多插件：

1
return {
2
  { "user/one", opts = {} },
3
  { "user/two" },
4
}

插件 spec 会合并：opts 可以合并，keys 可以合并，但 config 不会像 opts 那样合并。

最重要原则：能用 opts 就不要用 config。

推荐写法：

1
return {
2
  "user/plugin",
3
  opts = {
4
    key = "value",
5
  },
6
}

避免直接写：

1
require("plugin").setup({
2
  key = "value",
3
})

特殊情况下才写：

1
return {
2
  "user/plugin",
3
  opts = {},
4
  config = function(plugin, opts)
5
    require("plugin").setup(opts)
6
  end,
7
}

普通选项放在：

1
lua/config/options.lua

示例：

1
vim.opt.number = true
2
vim.opt.wrap = false

全局变量：

1
vim.g.varname = value

Autocmd 放在：

1
lua/config/autocmds.lua

示例：

1
vim.api.nvim_create_autocmd({ "BufRead", "BufNewFile" }, {
2
  pattern = "*.svx",
3
  command = "setlocal filetype=markdown",
4
})

项目级配置使用：

1
.lazy.lua

示例：

1
return {
2
  {
3
    "stevearc/conform.nvim",
4
    opts = {
5
      formatters_by_ft = {
6
        typescript = { "biome" },
7
      },
8
    },
9
  },
10
}

配置纪律：

插件配置进 lua/plugins。
普通选项进 lua/config/options.lua。
autocmd 进 lua/config/autocmds.lua。
项目差异进 .lazy.lua。
优先 opts。
慎用 config。
插件异常先试 lazy = false。
不要复制大段默认配置，除非 opts 覆盖不了。

对 Claude Code + tmux 工作流的取舍#

当前工作流以 Claude Code + tmux 为主，因此不建议把 LazyVim 搞成完整 IDE。更合适的方向是极简辅助。

推荐保留：

LazyVim 默认 LSP
TreeSitter
picker
diagnostics
formatter
gitsigns
lazygit
basic testing，可选
minimal theme

暂不建议折腾：

Avante.nvim
多套 AI chat 插件
复杂 DAP 容器调试
过度 session/tab/window 工作流
大量 snippets
大量主题切换
花时间优化 lazy loading

最值得定制的点：

TypeScript / Vue / Node.js extras。
Prettier / Biome 的项目级 .lazy.lua。
tmux pane 和 Neovim window 快捷键不要冲突。
clipboard 行为是否和系统剪贴板同步。
是否禁用 bufferline 或 explorer，保持极简。
Git hunk 和 lazygit 快捷键保留。
不内置复杂 AI，把 Claude Code 放 tmux pane。

7 天最小练习路线#

第 1 天：模式和移动#

1
Esc
2
i / a / o
3
w / e / b
4
0 / ^ / $ / g_
5
gg / G
6
Ctrl-d / Ctrl-u
7
s

目标：减少 hjkl 连按。

第 2 天：编辑语言#

1
dw
2
cw
3
dd
4
cc
5
D
6
C
7
ci"
8
di(
9
daw
10
.
11
u
12
<C-r>

目标：开始用“句子”编辑，而不是手动选。

第 3 天：文件和搜索#

1
<Space><Space>
2
<Space>ff
3
<Space>/
4
/
5
n / N
6
Ctrl-o / Ctrl-i

目标：能在项目里快速打开和定位。

第 4 天：LSP 和 diagnostics#

1
gd
2
gr
3
K
4
<Space>ca
5
<Space>cf
6
[d / ]d
7
<Space>x

目标：能读代码、跳定义、处理错误。

第 5 天：buffer/window#

1
H / L
2
[b / ]b
3
<Space>,
4
<Space>bd
5
<Space>wv
6
<Space>ws
7
Ctrl-h/j/k/l

目标：理解 Neovim 工作区。

第 6 天：Git hunk#

1
[h / ]h
2
<Space>ghp
3
<Space>ghs
4
<Space>ghr
5
<Space>gg

目标：不用离开编辑器也能处理局部 diff。

第 7 天：再开始改配置#

只改三类：

明确不想要的插件。
明确冲突的快捷键。
明确项目需要的 formatter、linter、test adapter。

总结#

LazyVim 的价值不是让 Neovim 像 VS Code，而是让 Vim 的编辑语言获得现代开发环境的支撑。

真正应该学的是：modal editing、motion、text object、register、macro、picker、quickfix/Trouble、LSP navigation、Lazy.nvim 配置合并模型。

真正不急着学的是：复杂 AI 插件、远程 DAP、自写 Neotest adapter、深度 lazy-loading 优化、大规模主题和 UI 调整。

落地时应先装一个极简 LazyVim，连续用 7 天，只记录阻碍工作的摩擦点。第 7 天再统一改配置，避免还没开始用就先配置三天。