166 lines
6.3 KiB
Markdown
166 lines
6.3 KiB
Markdown
# Neovim 配置
|
||
|
||
个人 Neovim 配置，目标版本 **0.12+**。
|
||
|
||
## 核心特性
|
||
|
||
- **内置插件管理器** — `vim.pack`（Neovim 0.12+），无需 lazy.nvim / packer
|
||
- **自定义懒加载框架** — `lua/lazy.lua`（约 35 行），通过 `on_event` / `on_keys` / `load` 延迟加载重型模块
|
||
- **mini.nvim 单体插件集** — starter、pick、extra、files、icons、notify、cmdline、completion、snippets、diff、surround
|
||
- **LSP + 代码格式化** — nvim-lspconfig + mason + conform.nvim，保存时自动格式化，支持全局/Buffer 级别开关
|
||
- **快速启动** — 禁用约 20 个内置插件，启用 Neovim 0.12+ 内置 UI 增强 (`vim._core.ui2`)
|
||
- **启动仪表盘** — ASCII Logo + 实时模块加载统计 + 启动耗时
|
||
- **Colorscheme 优化** — `ex-colors.nvim` 提取并生成精简版 colorscheme（默认 `ex-catppuccin-mocha`）
|
||
|
||
## 懒加载策略
|
||
|
||
| 触发条件 | 插件 |
|
||
|---------------|--------------------------------------|
|
||
| `VimEnter` | treesitter、lsp、icons |
|
||
| `InsertEnter` | completion、snippets |
|
||
| `BufReadPost` | diff、surround |
|
||
| `BufWritePre` | conform |
|
||
| 按键触发 | pick、files、fugitive、grugfar |
|
||
| 命令触发 | ex-colors (`:ExColors`) |
|
||
|
||
## 键位映射（Leader = 空格）
|
||
|
||
### 文件查找（mini.pick）
|
||
|
||
| 键位 | 动作 |
|
||
|----------------|-----------------------------------|
|
||
| `<leader>ff` | 查找文件 |
|
||
| `<leader>fw` | 实时 grep（项目中搜索文本） |
|
||
| `<leader>fa` | 查找所有文件（含隐藏和忽略） |
|
||
| `<leader>fh` | 搜索帮助标签 |
|
||
| `<leader>fo` | 最近打开的文件 |
|
||
| `<leader>fz` | 当前缓冲区行内搜索 |
|
||
| `<leader>sk` | 搜索键位映射 |
|
||
| `<leader><leader>` | Buffer 列表（支持 `<C-d>` 删除） |
|
||
| `<leader>ft` | 切换文件类型 |
|
||
|
||
### 文件浏览器（mini.files）
|
||
|
||
| 键位 | 动作 |
|
||
|------|---------------------------------------|
|
||
| `-` | 在当前文件所在目录打开文件浏览器 |
|
||
| `_` | 在项目根目录（git root）打开文件浏览器 |
|
||
|
||
### Git
|
||
|
||
| 键位 | 动作 |
|
||
|----------------|--------------------------|
|
||
| `<leader>gg` | Fugitive（全屏新标签页） |
|
||
| `<leader>gd` | Git diff 垂直分割 |
|
||
| `<leader>ghp` | 预览当前 hunk |
|
||
| `<leader>ghb` | Blame 当前行 |
|
||
| `<leader>gB` | Blame 整个文件 |
|
||
| `<leader>gD` | 查看文件 Git 历史 |
|
||
| `<leader>sr` | 搜索并替换（grug-far） |
|
||
|
||
### LSP 与诊断
|
||
|
||
| 键位 | 动作 |
|
||
|--------------|------------------------|
|
||
| `gd` | 跳转到定义 |
|
||
| `gh` | 悬停查看文档 |
|
||
| `<leader>ca` | 代码操作 |
|
||
| `<leader>cr` | 重命名符号 |
|
||
| `<leader>fm` | 格式化当前 Buffer |
|
||
| `df` | 显示行诊断浮动窗口 |
|
||
| `<leader>ds` | 诊断位置列表 |
|
||
| `]d` / `[d` | 下一个 / 上一个诊断 |
|
||
| `]e` / `[e` | 下一个 / 上一个错误 |
|
||
| `]w` / `[w` | 下一个 / 上一个警告 |
|
||
|
||
### Buffer 管理
|
||
|
||
| 键位 | 动作 |
|
||
|--------------|--------------------|
|
||
| `<leader>x` | 关闭当前 Buffer |
|
||
| `<leader>bn` | 新建 Buffer |
|
||
| `<leader>bo` | 关闭其他 Buffer |
|
||
|
||
### 编辑与搜索
|
||
|
||
| 键位 | 动作 |
|
||
|--------------|----------------------------|
|
||
| `<leader>ss` | 全局替换光标下的单词 |
|
||
| `<leader>ud` | 打开内置撤销树 |
|
||
| `<leader>uf` | 切换全局自动格式化 |
|
||
| `<leader>uF` | 切换当前 Buffer 自动格式化 |
|
||
| `<Esc>` | 清除搜索高亮 |
|
||
| `J` | 合并行且不移动光标 |
|
||
|
||
### 窗口与标签
|
||
|
||
| 键位 | 动作 |
|
||
|--------------|--------------------|
|
||
| `<C-h/j/k/l>` | 窗口间快速跳转 |
|
||
| `<leader>tc` | 关闭当前标签页 |
|
||
| `<leader>tn` | 新建标签页 |
|
||
| `<leader>]` | 下一个标签页 |
|
||
| `<leader>[` | 上一个标签页 |
|
||
|
||
### 终端
|
||
|
||
| 键位 | 动作 |
|
||
|--------------|----------------------------|
|
||
| `<leader>tt` | 打开新终端 |
|
||
| `<C-x>` | 从终端模式返回普通模式 |
|
||
|
||
### 文件操作
|
||
|
||
| 键位 | 动作 |
|
||
|--------------|----------------------------|
|
||
| `<C-s>` | 保存文件 |
|
||
| `<C-c>` | 复制整个文件内容到剪贴板 |
|
||
| `<leader>yp` | 复制相对文件路径 |
|
||
| `<leader>yP` | 复制绝对文件路径 |
|
||
|
||
## 命令
|
||
|
||
```vim
|
||
:PackAdd user/repo " 添加插件
|
||
:PackDel plugin-name " 删除插件
|
||
:PackUpdate [name] " 更新全部或指定插件
|
||
:ExColors! " 提取当前 colorscheme 为优化版 ex-colors
|
||
```
|
||
|
||
## 文件结构
|
||
|
||
```
|
||
init.lua -- 入口：禁用内置插件，加载核心模块
|
||
lua/options.lua -- 全局选项
|
||
lua/keymaps.lua -- 键位映射
|
||
lua/autocmds.lua -- 自动命令
|
||
lua/usercmds.lua -- :PackAdd / :PackDel / :PackUpdate
|
||
lua/pack.lua -- 插件声明 + 懒加载绑定
|
||
lua/lazy.lua -- 自定义懒加载原语（load / on_event / on_keys）
|
||
lua/plugins/
|
||
lsp.lua -- LSP + conform 格式化
|
||
treesitter.lua -- 语法树：延迟安装 parser、按 buffer 启用高亮
|
||
pick.lua -- mini.pick 封装：buffer picker、filetype picker
|
||
git.lua -- Git 工具：hunk 预览、blame、文件历史
|
||
nvim-pack-lock.json -- 插件锁定文件
|
||
colors/
|
||
ex-catppuccin-mocha.lua -- 默认配色（ex-colors 生成的优化版）
|
||
catppuccin-*.lua -- 原始 Catppuccin 配色方案
|
||
```
|
||
|
||
## 开发 / 验证
|
||
|
||
```bash
|
||
# 检查 init.lua 语法
|
||
nvim --headless -c 'lua dofile("init.lua")' -c 'qa!'
|
||
|
||
# 检查特定模块
|
||
nvim --headless -c 'lua require("pack")' -c 'qa!'
|
||
|
||
# 健康检查
|
||
nvim --headless -c 'checkhealth' -c 'qa!'
|
||
|
||
# 测量启动时间
|
||
nvim --startuptime /tmp/startup.log +q
|
||
```
|