mirror of
https://github.com/Dichgrem/Blog.git
synced 2025-08-01 09:19:32 -04:00
461 lines
16 KiB
Markdown
461 lines
16 KiB
Markdown
+++
|
||
title = "乱七八糟:lazyvim快速上手"
|
||
date = 2025-04-20
|
||
|
||
[taxonomies]
|
||
tags = ["乱七八糟"]
|
||
+++
|
||
|
||
前言 LazyVim 是一个基于 Neovim 的现代化配置框架，易于定制和扩展，这里对其介绍并说明使用方法。
|
||
|
||
<!-- more -->
|
||
## Lazy!
|
||
> Vim 是从早期的 vi 编辑器发展而来的增强版，其名称代表“Vi IMproved”。由荷兰程序员 Bram Moolenaar 于 1991 年首次发布。Vim 是开源软件，支持多种操作系统，包括 Unix、Linux、Windows 和 macOS 等。
|
||
|
||
> LazyVim 是一个基于 Neovim 的现代化配置框架，旨在简化 Neovim 的配置过程。它通过集成的 lazy.nvim 插件管理器，提供了一种易于定制和扩展配置的方式，结合了从头开始配置的灵活性和预配置设置的便利性 。
|
||
|
||
> LazyVim 是在Neovim的基础上进行配置，Neovim又继承了vim的操作模式，对vim不熟悉的同学可以看[这里](https://vimsheet.com/)或者本文末尾的 Vim 速查表.
|
||
|
||
## 安装
|
||
|
||
首先安装neovim,在arch linux上是：
|
||
```
|
||
paru -S neovim
|
||
```
|
||
在Ubuntu上是
|
||
```
|
||
sudo add-apt-repository ppa:neovim-ppa/unstable
|
||
sudo apt update
|
||
sudo apt install -y \ neovim git curl unzip build-essential ripgrep fd-find
|
||
```
|
||
|
||
备份现有配置：
|
||
```
|
||
mv ~/.config/nvim ~/.config/nvim.bak
|
||
mv ~/.local/share/nvim ~/.local/share/nvim.bak
|
||
```
|
||
克隆 LazyVim Starter 模板：
|
||
```
|
||
git clone https://github.com/LazyVim/starter ~/.config/nvim
|
||
```
|
||
启动 Neovim：
|
||
```
|
||
nvim
|
||
```
|
||
首次启动时，LazyVim 会自动安装并配置所需的插件。
|
||
|
||
## 结构
|
||
|
||
LazyVim 的配置目录通常位于``~/.config/nvim/``中：
|
||
```
|
||
~/.config/nvim
|
||
❯ tree
|
||
.
|
||
├── init.lua
|
||
├── lazy-lock.json
|
||
├── lazyvim.json
|
||
├── LICENSE
|
||
├── lua
|
||
│ ├── config
|
||
│ │ ├── autocmds.lua
|
||
│ │ ├── keymaps.lua
|
||
│ │ ├── lazy.lua
|
||
│ │ └── options.lua
|
||
│ └── plugins
|
||
│ ├── example.lua
|
||
│ └── mp.lua
|
||
├── README.md
|
||
└── stylua.toml
|
||
|
||
4 directories, 12 files
|
||
```
|
||
|
||
另外在``~/.local/share/nvim/lazy/LazyVim/lua/lazyvim/plugins/``目录下看到的文件结构，是 LazyVim 为其核心插件和扩展插件提供的模块化配置体系。这些配置文件并不直接出现在``~/.config/nvim/lua/plugins/``目录中，是因为 LazyVim 采用了模块化和懒加载的设计理念，将核心插件和配置封装在其自身的代码库中。
|
||
|
||
### 各文件和目录的作用
|
||
|
||
* **`init.lua`**：主配置文件，负责加载 `lua/config/lazy.lua`，从而引导整个 LazyVim 的初始化过程。
|
||
|
||
* **`lazy-lock.json`**：由 `lazy.nvim` 插件管理器生成的锁定文件，记录了已安装插件的精确版本，确保插件的一致性。
|
||
|
||
* **`lazyvim.json`**：用于记录通过 `:LazyExtras` 命令启用的额外功能（Extras），便于在不同设备间同步配置。
|
||
|
||
* **`LICENSE`** 和 **`README.md`**：分别为许可协议和项目说明文档。
|
||
|
||
* **`stylua.toml`**：`stylua` 的配置文件，用于格式化 Lua 代码。
|
||
|
||
* **`lua/config/`**：包含 Neovim 的基础配置文件，如自动命令（`autocmds.lua`）、快捷键（`keymaps.lua`）、插件管理（`lazy.lua`）和编辑器选项（`options.lua`）。这些文件会被 LazyVim 自动加载，无需手动引入。
|
||
|
||
* **`lua/plugins/`**：用于添加或修改插件配置的目录。您可以在此目录中添加新的 Lua 文件，以引入其他插件或更改现有插件的设置。
|
||
|
||
|
||
## Lazyvim自带配置
|
||
|
||
在 LazyVim 中，插件被分类为已加载（Loaded）和未加载（Not Loaded）。
|
||
|
||
### ✅ 已加载的插件（Loaded）
|
||
|
||
* **blink.cmp**：一个高性能、开箱即用的自动补全引擎，旨在替代 `nvim-cmp`，提供更快的性能和更少的配置需求。
|
||
|
||
* **bufferline.nvim**：用于在顶部显示缓冲区列表的插件，提供类似于浏览器标签页的界面。
|
||
|
||
* **friendly-snippets**：一个包含多种语言代码片段的集合，可与多个片段引擎（如 `luasnip`）配合使用。
|
||
|
||
* **gitsigns.nvim**：在编辑器中显示 Git 更改标记（如添加、修改、删除）的插件，增强版本控制的可视化。
|
||
|
||
* **lazy.nvim**：LazyVim 的插件管理器，支持懒加载和依赖管理，提升启动速度和性能。
|
||
|
||
* **lualine.nvim**：一个高度可定制的状态栏插件，支持多种主题和组件。
|
||
|
||
* **mason-lspconfig.nvim** & **mason.nvim**：用于自动安装和配置 LSP（语言服务器协议）服务器的插件组合，简化开发环境的设置。
|
||
|
||
* **mini.ai**、**mini.pairs**：`mini.nvim` 插件集合的一部分，分别用于增强文本对象操作和自动括号配对功能。
|
||
|
||
* **noice.nvim**：改进 Neovim 消息和命令行界面的插件，提供更丰富的 UI 体验。
|
||
|
||
* **nui.nvim**：一个用于构建 Neovim 用户界面的 Lua 库，被多个插件作为依赖使用。
|
||
|
||
* **nvim-lint**：一个异步代码检查器，支持多种语言的语法和风格检查。
|
||
|
||
* **nvim-lspconfig**：提供预配置的 LSP 客户端设置，简化语言服务器的集成。
|
||
|
||
* **nvim-treesitter**、**nvim-treesitter-textobjects**、**nvim-ts-autotag**：基于 Tree-sitter 的语法高亮和代码结构分析插件，增强代码编辑体验。
|
||
|
||
* **persistence.nvim**：自动保存和恢复会话的插件，方便在不同项目之间切换。
|
||
|
||
* **snacks.nvim**：提供快速导航和编辑功能的插件，提升编辑效率。
|
||
|
||
* **todo-comments.nvim**：高亮和管理代码中的 TODO、FIXME 等注释的插件，方便任务跟踪。
|
||
|
||
* **tokyonight.nvim**：一个流行的 Neovim 主题，提供多种配色方案。
|
||
|
||
* **trouble.nvim**：一个用于显示诊断信息（如 LSP 错误、警告）的插件，提供统一的界面。
|
||
|
||
* **ts-comments.nvim**：基于 Tree-sitter 的注释插件，支持多语言的智能注释功能。
|
||
|
||
* **which-key.nvim**：在按下快捷键时弹出可用键位提示的插件，帮助记忆和发现快捷键。
|
||
|
||
|
||
### ❌ 未加载的插件（Not Loaded）
|
||
|
||
* **catppuccin**：一个柔和的 Neovim 主题，提供多种风格的配色方案。
|
||
|
||
* **conform.nvim**：一个用于代码格式化的插件，支持多种语言的格式化工具。
|
||
|
||
* **grug-far.nvim**：一个快速的全局查找和替换插件，提供直观的界面和操作。
|
||
|
||
* **lazydev.nvim**：用于 LazyVim 插件开发的辅助工具，简化开发流程。
|
||
|
||
* **markdown-preview.nvim**：在浏览器中实时预览 Markdown 文件的插件，提升写作体验。
|
||
|
||
* **plenary.nvim**：一个 Lua 函数库，提供多种实用功能，被许多插件作为依赖使用。
|
||
|
||
## 自定义配置
|
||
|
||
- **添加插件**：在 lua/plugins/ 目录下创建一个新的 Lua 文件，返回插件的配置表。
|
||
|
||
- **修改快捷键**：编辑 lua/config/keymaps.lua 文件，添加或修改快捷键映射。
|
||
|
||
- **调整选项**：编辑 lua/config/options.lua 文件，设置 Neovim 的行为选项。
|
||
|
||
|
||
## 常用快捷键
|
||
|
||
LazyVim 默认使用``<space> 作为 <leader>``，\ 作为``<localleader>``，并通过 which-key.nvim 插件动态展示所有以``<space>``开头的可用映射，极大降低了记忆成本。
|
||
|
||
- **导航与窗口管理**
|
||
```
|
||
- 在窗口间切换：Ctrl +h / Ctrl +j / Ctrl +k / Ctrl +l
|
||
- 调整当前窗口尺寸：Ctrl + ↑ / Ctrl + ↓ / Ctrl + ← / Ctrl + →
|
||
```
|
||
- **缓冲区切换与管理**
|
||
```
|
||
- 切换到上一个/下一个缓冲区：Shift +h / Shift +l
|
||
- 切换“另一个”缓冲区：Space + b + b
|
||
- 关闭当前缓冲区：Space + b + d
|
||
- 只保留当前缓冲区：Space + b + o
|
||
```
|
||
- **文件与搜索**
|
||
```
|
||
- 新建文件：Space + f + n
|
||
- 打开文件（普通命令）：输入 :e <文件名> 回车
|
||
- 在项目根目录查找文件：Space + Space
|
||
- 在项目根目录查找文件（另一路径）：Space + f + f
|
||
- 在当前工作目录查找文件：Space + f + F
|
||
- 查找 Git 管理的文件：Space + f + g
|
||
- 列出最近打开的文件：Space + f + r
|
||
- 列出所有缓冲区：Space + ,
|
||
- 全局全文搜索：Space + /
|
||
```
|
||
- **分割与终端**
|
||
```
|
||
- 向下分割：Space + -
|
||
- 向右分割：Space + |
|
||
- 关闭当前窗口：Space + w + d
|
||
- 窗口最大化/恢复：Space + w + m 或 Space + u + Z
|
||
- 打开根目录终端：Space + f + t
|
||
- 打开当前目录终端：Space + f + T
|
||
- 切换（隐藏/显示）终端：Ctrl + /
|
||
```
|
||
- **LSP 相关**
|
||
```
|
||
- 跳转到定义：g + d
|
||
- 查找引用：g + r
|
||
- 跳转到实现：g + I
|
||
- 跳转到声明：g + D
|
||
- 查看文档悬停：K
|
||
- 插入模式签名帮助：Ctrl + k
|
||
- 代码操作：Space + c + a
|
||
- 重命名：Space + c + r
|
||
- 运行 CodeLens：Space + c + c
|
||
- 显示行诊断：Space + c + d
|
||
```
|
||
- **Git 操作**
|
||
```
|
||
- 查看状态：Space + g + s
|
||
- 查看差异：Space + g + d
|
||
- 查看行级 Blame：Space + g + b
|
||
- 在浏览器打开当前文件：Space + g + B
|
||
- Git Stash（snacks.nvim）：Space + g + S
|
||
```
|
||
- **诊断与快速修复**
|
||
```
|
||
- 打开 Location List：Space + x + l
|
||
- 打开 Quickfix List：Space + x + q
|
||
- 在 Quickfix 跳转：[ q / ] q
|
||
```
|
||
|
||
## 添加插件
|
||
|
||
- **Markdown预览**
|
||
|
||
在``~/config/nvim/lua/plugins/``下新建一个mp.lua，写入如下配置：
|
||
|
||
```
|
||
return {
|
||
{
|
||
"iamcco/markdown-preview.nvim",
|
||
cmd = { "MarkdownPreviewToggle", "MarkdownPreview", "MarkdownPreviewStop" },
|
||
ft = { "markdown" },
|
||
build = ':call mkdp#util#install()'
|
||
}
|
||
}
|
||
```
|
||
|
||
随后即可在 Neovim 中打开一个 Markdown 文件，执行以下命令启动预览：
|
||
```
|
||
:MarkdownPreview
|
||
```
|
||
|
||
## tips
|
||
|
||
- gcc:注释当前行；
|
||
- g+ctrl+g:显示信息；
|
||
- alt+h：显示隐藏文件；
|
||
- space+c+f:将当前代码格式化；
|
||
- 设置文件编码``:set fileencoding?``
|
||
- 设置换行符``:set fileformat=unix``
|
||
- lazyvim的字体是和终端相同的，不同单独设置；
|
||
- lazyvim中在侧边栏选择文件按d删除,按y复制,按p粘贴,按a创建,按r重命名；
|
||
- lazyvim中的行号是非自然序的，这是为了方便光标移动而设置的：你可以在正常模式中通过10k快速移动光标到10行前，10j，10h，10l同理。
|
||
- LSP快捷操作：
|
||
|
||
| 快捷键 | 功能 |
|
||
| ------------ | ----------------------- |
|
||
| `gd` | 跳转到定义（Go to Definition） |
|
||
| `gr` | 查找引用（Go to References） |
|
||
| `K` | 显示悬浮文档（Hover） |
|
||
| `<leader>rn` | 重命名（Rename） |
|
||
| `<leader>ca` | Code Action（修复） |
|
||
| `gl` | 显示诊断信息（Diagnostic） |
|
||
| `[d` / `]d` | 上/下一个诊断问题 |
|
||
|
||
## Edit!
|
||
|
||
> 编辑器的基本素养
|
||
|
||
``文件操作``
|
||
- 创建文件/文件夹
|
||
- 打开/关闭/切换文件
|
||
- 复制/粘贴
|
||
- 写入/保存/退出
|
||
- 搜索替换
|
||
|
||
``字符处理``
|
||
- LF/CRLF处理
|
||
- 零宽字符处理
|
||
- GBK/UTF-8处理
|
||
|
||
``终端``
|
||
- 打开终端/复用终端
|
||
|
||
``其他功能``
|
||
- LSP
|
||
- 代码调试
|
||
- 工作区切换
|
||
- Git支持
|
||
- 主题与显示效果
|
||
|
||
|
||
## 一份优秀的 Vim 速查表
|
||
|
||
> 翻译自``https://vimsheet.com/``
|
||
|
||
我整理了一份我每天使用的 Vim 基本命令列表，并提供了一些配置建议，使 Vim 更加实用。因为没有配置的 Vim 使用起来会比较痛苦。
|
||
|
||
## 基础命令
|
||
|
||
### 光标移动（普通模式/可视模式）
|
||
|
||
* `h` `j` `k` `l`：左、下、上、右移动
|
||
* `w` / `b`：下一个/上一个单词
|
||
* `W` / `B`：下一个/上一个以空格分隔的单词
|
||
* `e` / `ge`：下一个/上一个单词的结尾
|
||
* `0` / `$`：行首/行尾
|
||
* `^`：行首第一个非空白字符（等同于 `0w`）
|
||
|
||
### 编辑文本
|
||
|
||
* `i` / `a`：在光标处/之后进入插入模式
|
||
* `I` / `A`：在行首/行尾进入插入模式
|
||
* `o` / `O`：在当前行下方/上方插入空行
|
||
* `Esc` 或 `Ctrl+[`：退出插入模式
|
||
* `d`：删除
|
||
* `dd`：删除整行
|
||
* `c`：删除并进入插入模式
|
||
* `cc`：删除整行并进入插入模式
|
||
|
||
### 操作符
|
||
|
||
* 操作符也适用于可视模式
|
||
* `d`：从光标处删除到移动目标
|
||
* `c`：从光标处删除到移动目标，并进入插入模式
|
||
* `y`：从光标处复制到移动目标
|
||
* `>`：缩进一级
|
||
* `<`：取消缩进一级
|
||
* 操作符可与移动命令组合使用，例如：`d$` 删除从光标到行尾的内容
|
||
|
||
### 标记文本（可视模式）
|
||
|
||
* `v`：进入可视模式
|
||
* `V`：进入行可视模式
|
||
* `Ctrl+v`：进入块可视模式
|
||
* `Esc` 或 `Ctrl+[`：退出可视模式
|
||
|
||
### 剪贴板操作
|
||
|
||
* `yy`：复制整行
|
||
* `p`：在光标后粘贴
|
||
* `P`：在光标前粘贴
|
||
* `dd`：剪切整行
|
||
* `x`：删除当前字符
|
||
* `X`：删除前一个字符
|
||
* 默认情况下，`d` / `c` 会将删除的内容复制到剪贴板
|
||
|
||
### 退出
|
||
|
||
* `:w`：保存文件但不退出
|
||
* `:wq`：保存并退出
|
||
* `:q`：退出（如果有修改会失败）
|
||
* `:q!`：强制退出并放弃修改
|
||
|
||
### 搜索/替换
|
||
|
||
* `/pattern`：搜索 pattern
|
||
* `?pattern`：向上搜索 pattern
|
||
* `n`：重复上一次搜索（同方向）
|
||
* `N`：重复上一次搜索（反方向）
|
||
* `:%s/old/new/g`：全文件替换 old 为 new
|
||
* `:%s/old/new/gc`：全文件替换 old 为 new，并逐个确认
|
||
|
||
### 常规命令
|
||
|
||
* `u`：撤销
|
||
* `Ctrl+r`：重做
|
||
|
||
## 高级命令
|
||
|
||
### 光标移动
|
||
|
||
* `Ctrl+d`：向下移动半页
|
||
* `Ctrl+u`：向上移动半页
|
||
* `}`：跳转到下一个段落（空行）
|
||
* `{`：跳转到上一个段落（空行）
|
||
* `gg`：跳转到文件顶部
|
||
* `G`：跳转到文件底部
|
||
* `:[num]`：跳转到指定行号
|
||
* `Ctrl+e` / `Ctrl+y`：向下/向上滚动一行
|
||
|
||
### 字符搜索
|
||
|
||
* `f [char]`：向前移动到指定字符
|
||
* `F [char]`：向后移动到指定字符
|
||
* `t [char]`：向前移动到指定字符之前
|
||
* `T [char]`：向后移动到指定字符之前
|
||
* `;` / `,`：重复上一次字符搜索（正向/反向）
|
||
|
||
### 编辑文本
|
||
|
||
* `J`：将下一行合并到当前行
|
||
* `r [char]`：用指定字符替换当前字符（不进入插入模式）
|
||
|
||
### 可视模式
|
||
|
||
* `O`：移动到块的另一个角
|
||
* `o`：移动到标记区域的另一端
|
||
|
||
### 文件标签
|
||
|
||
* `:e filename`：编辑文件
|
||
* `:tabe`：打开新标签页
|
||
* `gt`：切换到下一个标签页
|
||
* `gT`：切换到上一个标签页
|
||
* `:vsp`：垂直分割窗口
|
||
* `Ctrl+ws`：水平分割窗口
|
||
* `Ctrl+wv`：垂直分割窗口
|
||
* `Ctrl+ww`：在窗口间切换
|
||
* `Ctrl+wq`：关闭当前窗口
|
||
|
||
### 标记
|
||
|
||
* 标记允许你跳转到代码中的指定位置
|
||
* `m{a-z}`：在光标位置设置标记 {a-z}
|
||
* 大写标记 {A-Z} 是全局标记，可跨文件使用
|
||
* `'{a-z}`：跳转到设置标记的行首
|
||
* `''`：返回上一个跳转位置
|
||
|
||
### 文本对象
|
||
|
||
* 例如：`def (arg1, arg2, arg3)`，光标在括号内
|
||
* `di(`：删除括号内的内容，即“删除最近括号内的内容”
|
||
* 如果没有文本对象，你需要使用 `T(dt)` 来实现相同的功能
|
||
|
||
### 常规命令
|
||
|
||
* `.`：重复上一次命令
|
||
* 在插入模式下，`Ctrl+r 0`：插入最近复制的文本
|
||
* `gv`：重新选择上一次选中的文本块
|
||
* `%`：在匹配的 `()` 或 `{}` 之间跳转
|
||
|
||
---
|
||
|
||
如果你希望将此速查表保存为 PDF 或打印出来，可以使用 Markdown 编辑器（如 Typora）或在线工具（如 Dillinger）进行导出。
|
||
|
||
此外，Vim 的默认配置可能不够友好，建议你参考以下资源进行配置优化：
|
||
|
||
* [vim-sensible](https://github.com/tpope/vim-sensible)：提供一套合理的默认配置
|
||
* [vim-pathogen](https://github.com/tpope/vim-pathogen)：插件管理工具
|
||
* [ag.vim](https://github.com/rking/ag.vim)：快速全局搜索插件
|
||
* [ctrlp.vim](https://github.com/ctrlpvim/ctrlp.vim)：文件和缓冲区快速切换插件
|
||
* [nerdcommenter](https://github.com/preservim/nerdcommenter)：代码注释插件
|
||
|
||
这些插件可以显著提升 Vim 的功能，使其更接近一个完整的 IDE。
|
||
|
||
---
|
||
🔗
|
||
|
||
[用 neovim 写 markdown 是一种什么样的体验](https://yelog.org/2024/08/02/write-markdown-in-neovim-experience-and-tips/)
|
||
|
||
---
|
||
**Done.**
|