#LazyVim 使用手册（Windows / Arch Linux / macOS）

• 版本：LazyVim v16.0.1 ｜ 运行于 Neovim 0.12.x（官方要求 ≥ 0.11.2，需带 LuaJIT）
• 官方文档：https://www.lazyvim.org/ ｜ GitHub：https://github.com/LazyVim/LazyVim ｜ Starter：https://github.com/LazyVim/starter
• 整理日期：2026-09-14
• 说明：本手册以官方文档（安装 / 键位 / Extras / 配置）为准，并参考听风 347 的《LazyVim 使用教程与快捷键指南》（同为 LazyVim 16.x）。
• 先记住四件事：
  1. <leader> 就是空格键。<leader>ff = 按「空格、f、f」。\ 是 <localleader>。
  2. 不必背完：普通模式按一下 Space，which-key 会弹出可继续按的菜单；Space ? 只看当前缓冲区可用的键。
  3. :Tutor 是练 Vim 基础的最佳交互教程。
  4. <Esc> 还会清除搜索高亮；<C-s> 在普通/插入/可视模式都能保存。

#目录

0. 平台可用性总表
1. LazyVim 是什么
2. 前置条件
3. 安装（分平台）
4. 目录结构与配置文件
5. 界面与核心概念
6. Vim 基础：操作符 + 范围
7. 键位大全（官方默认）
8. Snacks Picker 小抄
9. Extras 与语言支持
10. 与 Vim 原生键的冲突
11. 自定义配置
12. 平台注意事项
13. 速查表
14. 参考链接

#0. 平台可用性总表

关键点：LazyVim 的配置三平台写法一致（都是 lua/config + lua/plugins），只有路径不同——Unix 是 ~/.config/nvim，Windows 是 %LOCALAPPDATA%\nvim。

#1. LazyVim 是什么

LazyVim 是一套基于 lazy.nvim 插件管理器的 Neovim 配置框架（不是 Neovim 分支，也不是插件）。它把 Neovim 变成开箱可用的 IDE，同时保留「用 lazy.nvim 轻松扩展/覆盖」的能力。

特性：

• 🔥 把 Neovim 变成完整 IDE
• 💤 用 lazy.nvim 定制与扩展
• 🚀 启动快
• 🧹 options / autocmds / keymaps 都有合理默认
• 📦 预配置大量插件

核心工作流组件（LazyVim 16.x）：

⚠️ 注意：LazyVim 16.x 用 Snacks 取代了 Telescope，用 blink.cmp 取代了 nvim-cmp。网上老教程里的 Telescope 键位已不再适用。

#2. 前置条件

官方 Requirements：

• Neovim ≥ 0.11.2（必须带 LuaJIT）
• Git ≥ 2.19.0（partial clone）
• curl（blink.cmp 需要）
• tree-sitter-cli + C 编译器（nvim-treesitter）
• Nerd Font v3.0+（可选，但图标需要）
• lazygit（可选）
• 可选（fzf-lua）：fzf ≥ 0.25.1、ripgrep、fd
• 支持 true color + undercurl 的终端：kitty、WezTerm、Alacritty、iTerm2、Ghostty

#3. 安装（分平台）

LazyVim 通过 Starter 模板安装。

#3.1 Linux / macOS

# 1) 备份现有配置（required）
mv ~/.config/nvim{,.bak}
# 可选但推荐
mv ~/.local/share/nvim{,.bak}
mv ~/.local/state/nvim{,.bak}
mv ~/.cache/nvim{,.bak}

# 2) 克隆 starter
git clone https://github.com/LazyVim/starter ~/.config/nvim

# 3) 删掉 .git（方便以后纳入自己的仓库）
rm -rf ~/.config/nvim/.git

# 4) 启动
nvim

#3.2 Windows（PowerShell）

# 1) 备份
Move-Item $env:LOCALAPPDATA\nvim $env:LOCALAPPDATA\nvim.bak
Move-Item $env:LOCALAPPDATA\nvim-data $env:LOCALAPPDATA\nvim-data.bak

# 2) 克隆 starter
git clone https://github.com/LazyVim/starter $env:LOCALAPPDATA\nvim

# 3) 删除 .git
Remove-Item $env:LOCALAPPDATA\nvim\.git -Recurse -Force

# 4) 启动
nvim

#3.3 用 Docker 试用

docker run -w /root -it --rm fedora:latest sh -uelic '
  dnf copr enable -y dejan/lazygit
  dnf install -y git lazygit fd-find curl ripgrep tree-sitter-cli neovim
  git clone https://github.com/LazyVim/starter ~/.config/nvim
  cd ~/.config/nvim && nvim'

#3.4 装完先体检

:LazyHealth

它会加载所有插件并检查是否一切正常。

#4. 目录结构与配置文件

Starter 的结构：

~/.config/nvim/                 （Windows: %LOCALAPPDATA%\nvim\）
├── init.lua                    # 入口：require("config.lazy")
├── lazyvim.json                # 已启用的 Extras 记录（:LazyExtras 写入）
├── stylua.toml                 # Lua 格式化风格
└── lua/
    ├── config/
    │   ├── lazy.lua            # 引导 lazy.nvim + 载入 LazyVim
    │   ├── options.lua         # vim.opt.* 选项
    │   ├── keymaps.lua         # 自定义键位
    │   └── autocmds.lua        # 自动命令
    └── plugins/                # 你的插件覆盖（*.lua，每个返回一个 spec）
        └── example.lua

关键点：

• lua/config/lazy.lua 里 { "LazyVim/LazyVim", import = "lazyvim.plugins" } 载入 LazyVim 全部默认插件。
• lua/plugins/*.lua 用来覆盖或追加插件（同名 spec 会合并）。
• lazyvim.json 记录启用的 Extras，nvim 启动时按它加载。

#5. 界面与核心概念

#6. Vim 基础：操作符 + 范围

Vim 的高效不在记很多快捷键，而在把命令当短语组合：

[次数] + 操作符 + 移动范围 / 文本对象

• 操作符：d 删除、c 修改、y 复制
• 范围：w 下个词、$ 行尾、iw 当前词内部
• 例：dw 删到下一个词、3dw 连删三个词、d$（=D）删到行尾、ciw 改写当前词、ci" 改双引号内、yap 复制整段
• 操作符重复一次通常表示「整行」：dd cc yy >> << ==

#6.1 进入插入与基础修改

#6.2 移动范围

#6.3 文本对象（i 内 / a 含边界）

#6.4 复制粘贴与寄存器

#6.5 可视选择、搜索、宏

#7. 键位大全（官方默认）

完整索引见 https://www.lazyvim.org/keymaps。下表为 LazyVim 核心默认（不含需要 Extra 的项）。

#7.1 通用 / 窗口 / 缓冲区

#7.2 标签页

#7.3 LSP（需语言服务器附着）

#7.4 诊断 / 格式化 / Trouble

#7.5 文件与检索（Snacks）

#7.6 Git（gitsigns 与 Snacks）

#7.7 UI 开关（<leader>u）

#7.8 会话 / 终端 / 其它

#8. Snacks Picker 小抄

多数 <leader>f* / <leader>s* 会打开 Snacks Picker。输入是模糊匹配（abc 可匹配中间有间隔的候选；含大写则大小写敏感）。

#9. Extras 与语言支持

Extras 是 LazyVim 的按需扩展机制——用 :LazyExtras 打开管理界面，选择后写入 lazyvim.json 的 extras 数组，重启 Neovim 生效。

分类：

示例（启用 Copilot）：

// lazyvim.json
{
  "extras": [
    "lazyvim.plugins.extras.ai.copilot"
  ]
}

只启用你真正需要的 Extra：不同 AI Extra 之间键位可能重叠；以 Space sk 和 :verbose nmap 看运行时结果为准。

#9.1 补全（blink.cmp）

⚠️ 不要在不了解影响时覆盖 <C-y>、<Tab>、<CR>、<C-n>、<C-p>——它们影响整个补全菜单。

#9.2 Markdown（lang.markdown Extra）

#10. 与 Vim 原生键的冲突

LazyVim 给部分 Vim 原生键换了动作。官方键位页是「核心 + 所有 Extra」的总索引，不代表你环境里全部启用。

诊断冲突的通用方法：

:verbose nmap <按键>     " 看最后是谁定义了映射

#11. 自定义配置

#11.1 选项

-- lua/config/options.lua
vim.opt.relativenumber = true
vim.opt.scrolloff = 8

#11.2 自定义键位

-- lua/config/keymaps.lua
vim.keymap.set("n", "<leader>pv", vim.cmd.Ex, { desc = "打开文件管理器" })

#11.3 覆盖 / 追加插件

-- lua/plugins/example.lua
return {
  -- 覆盖已有插件的 opts
  {
    "folke/tokyonight.nvim",
    opts = { transparent = true },
  },
  -- 追加新插件
  {
    "stevearc/dressing.nvim",
    event = "VeryLazy",
  },
}

#11.4 常用入口

#12. 平台注意事项

#12.1 Windows

1. 配置路径是 %LOCALAPPDATA%\nvim（不是 ~/.config/nvim），数据在 %LOCALAPPDATA%\nvim-data。
2. 用官方 Starter 的 PowerShell 步骤安装。
3. 需要 true color + undercurl：推荐 WezTerm / Alacritty / Ghostty。
4. curl 是 blink.cmp 的依赖，Windows 10+ 自带 curl.exe。
5. tree-sitter 需要 C 编译器（可装 MSVC 或 mingw）。
6. lazygit：winget install JesseDuffield.lazygit。

#12.2 Arch Linux

sudo pacman -S neovim git lazygit fd ripgrep fzf tree-sitter-cli
# Nerd Font（可选）
sudo pacman -S ttf-nerd-fonts-symbols

#12.3 macOS

brew install neovim git lazygit fd ripgrep fzf tree-sitter-cli
brew install --cask font-fira-code-nerd-font   # 可选

#12.4 三平台通用

• 用带 Nerd Font 的终端，否则图标显示为方块。
• 首次启动 nvim 会同步下载全部插件，耐心等待（:Lazy 可看进度）。
• 升级 LazyVim 本体：:Lazy → S（Sync），或 :Lazy update。
• 按键没反应时的检查顺序：① 先 <Esc> 回普通模式 → ② 按 Space 看 which-key → ③ Space sk 搜按键 → ④ :verbose nmap <键> → ⑤ :checkhealth lazyvim。

#13. 速查表

最该形成肌肉记忆的一组

每天都会用到的 Vim 组合

ciw   改当前词          ci"   改双引号内
d$    删到行尾          yap   复制整段
gg / G 文件首 / 尾      <C-o>/<C-i> 跳转后退/前进
.     重复上次修改      <C-r> 重做

命令入口

:Lazy        " 插件管理
:LazyExtras  " Extras
:Mason       " LSP/formatter/linter
:LazyHealth  " 体检
:Tutor       " Vim 教程

#14. 参考链接

官方

• 官网 / Getting Started：https://www.lazyvim.org/
• 安装：https://www.lazyvim.org/installation
• 键位总表：https://www.lazyvim.org/keymaps
• 配置：https://www.lazyvim.org/configuration
• Extras：https://www.lazyvim.org/extras
• 插件：https://www.lazyvim.org/plugins
• What's new：https://www.lazyvim.org/news
• GitHub：https://github.com/LazyVim/LazyVim
• Starter 模板：https://github.com/LazyVim/starter

学习资料

• 听风 347《LazyVim 使用教程与快捷键指南》：https://tingfeng347.github.io/2026/07/31/LazyVim%20%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B%E4%B8%8E%E5%BF%AB%E6%8D%B7%E9%94%AE%E6%8C%87%E5%8D%97/
• 视频入门（elijahmanor）：https://www.youtube.com/watch?v=N93cTbtLCIM
• 在线书《LazyVim for Ambitious Developers》：https://lazyvim-ambitious-devs.phillips.codes
• Neovim 用户手册：https://neovim.io/doc/user/usr_02.html、https://neovim.io/doc/user/usr_04.html

相关文件位置

截图来自 LazyVim 官方文档与仓库 https://www.lazyvim.org、https://github.com/LazyVim/LazyVim。版权归 LazyVim 项目所有，本手册仅供个人学习使用。