终于把 vim 弄成了 vscode 的模样
2022-02-13 凌晨发布3,972 次点击5 条评论需阅读16分钟
技术的路Vim

终于把 vim 弄成了 vscode 的模样

花了几天时间, 终于把 vim 弄成了 vscode 的模样

本文首发于:itsuki.cn个人博客
仓库源代码:SkCode

前言

从 20 年开始接触 vim, 一开始可能是为了装逼, 后面发现 vim 还是挺不错的, 特别是用熟了之后形成了自己的工作流, 要方便很多. 我没有学过 vimscript, 基本上 所有的插件都是看的官方文档或者别人的配置文件, 所以就属于直接拿代码的状态, 没有去好好去研究过, 后面接触到了可以使用 lua 来配置, 寒假在家没事做, 于是学习了一下 lua 来配置 vim , 我一直认为最好的学习是写代码、借鉴优秀的代码 .
最开始看的 lua 配置的 vim 是LunarVim, 当时才不到几百 star, 转眼间现在已经 7k star 了, 我的 vim 配置是从这个库的作者ChristianChiarulli他身上学到的, 然后最近他开了一个新的仓库, 讲解就是如何使用 lua 一步步配置 vim: Neovim-from-scratch, 所以一开始我在不断的做加法, 然后在学习他的配置时又看到了另外一个库VapourNvim, 这个更加的简单易上手, 他们都有配套的视频, 这是我觉得最棒的地方, 就在这样子的一点点看视频+看官方文档+看他们配置之后, 我的 SkCode 有了第一版.
而最终 SkCode 是根据 NvChad(它是一个优秀且支持拓展的 nvim lua 配置)"抄袭"而来, 你可以理解成 SkCode 它的代码都来源于这个仓库. SkCode 的代码结构是来源于 NvChad, 但是 SkCode 也绝不是简简单单的抄代码, 我希望 vim 的配置更加简单, 所以将一些代码进行优化, 删除不需要的功能, 添加人性化的键位绑定, 以及提供前端的 Lsp 配置, 于是就出现了 SkCode.

特点

  1. 开箱即用
  2. 简单快速
  3. 风格统一

开箱即用

SkCode 提供了前端(React、Vue)等基本的开发配置, 保证了在前端方面(自己是前端, 懒得提供其他的了)的开箱即用, 如果你想使用其他语言, 只需要在 Lsp 文件 服务即可.

简单快速

SkCode 借鉴了 NvChad 的 Packer 配置, 通过懒加载的方式加载所有插件, 因此它有很快的启动速度.

风格统一

NvChad 提供了风格统一的主题, SkCode 在此基础上进行了扩展, 在 Code Actions、Code renamer、Telescope 等插件上都进行了配置, 以达到相同的 UI 显示效果, 具体看下面效果图.

环境

  1. neovim >= 6.0: 必须
  2. lazygit: 可选

安装

git clone https://github.com/itsuki0927/SkCode ~/.config/nvim
nvim +PackerSync

效果

主题

nvim-theme
nvim-theme

首页

nvim-alpha
nvim-alpha

自动完成

nvim-cmp
nvim-cmp

lsp

nvim-lsp
nvim-lsp

Code Actions

nvim-code-actions
nvim-code-actions

重命名

nvim-code-renamer
nvim-code-renamer

文件树

nvim-tree
nvim-tree

模糊搜索

nvim-telescope
nvim-telescope

配置

键位配置

SkCode 提供了默认的键位配置. 以下是常用的键位配置, 更多的键位配置可以参看键位配置文件: mappings, 或者查看对应插件的配置, 它们有提供默认的键位配置.

常用键位

| 键位 | 含义 | | -------------- | --------------- | | <ctrl>h | 聚焦到左窗口 | | <ctrl>l | 聚焦到右窗口 | | <ctrl>k | 聚焦到上窗口 | | <ctrl>j | 聚焦到下窗口 | | <leader>x | 关闭当前 Buffer | | <leader>w | 保存当前 Buffer | | <leader>q | 退出当前 Buffer | | <leader><CR> | 取消高亮 | | jk | Esc |

Renamer

| 键位 | 含义 | | ------------ | ---------- | | <leader>rn | 变量重命名 |

bufferline

| 键位 | 含义 | | --------- | ------------- | | <tab> | 下一个 Buffer | | <S-tab> | 上一个 Buffer |

Comment

| 键位 | 含义 | | ----------- | -------- | | <leader>/ | 切换注释 | | gcc | 切换注释 |

todo-comments

| 键位 | 含义 | | ------------ | --------- | | <leader>tl | todo 列表 | | <leader>ts | todo 搜索 |

NvimTree

| 键位 | 含义 | | ----------- | -------------- | | <leader>e | 切换 NvimTree | | a | 创建文件 | | d | 删除文件 | | h | 折叠当前节点树 | | l | 编辑当前文件 |

Telescope

| 键位 | 含义 | | ------------ | --------------------- | | <leader>f | 搜索文件 | | <leader>F | 搜索文件内容 | | <leader>sb | 搜索当前打开的 Buffer | | <leader>sk | 搜索设置的 keymaps | | <leader>sc | 搜索设置的 commands |
插入模式:
| 键位 | 含义 | | ---------- | ---------------- | | <ctrl>j | 移动到下一项 | | <ctrl>k | 移动到上一项 | | <esc> | 关闭 Telescope | | <ctrl-[> | 关闭 Telescope | | <cr> | 打开文件 | | <ctrl-x> | 向下分屏打开文件 | | <ctrl-v> | 向右分屏打开文件 | | <M-p> | 切换文件预览 |
正常模式:
| 键位 | 含义 | | ---- | -------------- | | j | 移动到下一项 | | k | 移动到上一项 | | gg | 移动到第一项 | | G | 移动到最后一项 |

Lsp

| 键位 | 含义 | | ---- | ---------------- | | gD | 查看类型定义 | | gd | 查看定义 | | K | hover | | gi | 查看实现 | | gk | 查看当前文档 | | gr | 查看引用 | | gl | 显示当前行的诊断 | | [d | 上一个 Lsp | | ]d | 下一个 Lsp |

Gitsign

| 键位 | 含义 | | ------------ | ----------------- | | ]c | 下一个 hunk | | [c | 上一个 hunk | | <leader>hr | reset hunk | | <leader>hR | reset buffer hunk | | <leader>hs | stage hunk | | <leader>hS | reset buffer hunk | | <leader>hu | undo stage hunk | | <leader>hp | preview hunk | | <leader>hb | blame line | | <leader>tb | toggle blame line | | <leader>hd | diff |

目录结构

├── README.md                                    # 文档
├── init.lua                                     # 入口文件
├── lua
│   ├── colors
│   │   ├── highlights.lua                       # 高亮
│   │   └── init.lua                             # 主题
│   ├── core                                     # 核心功能文件夹
│   │   ├── autocmds.lua                         # 自动命令
│   │   ├── default_config.lua                   # 默认配置
│   │   ├── mappings.lua                         # 键位配置
│   │   ├── options.lua                          # vim 选项配置
│   │   └── utils.lua                            # 工具函数
│   └── plugins                                  # 插件配置文件夹
│       ├── configs                              # 插件配置
│       │   ├── icons.lua                        # 图标
│       │   ├── lsp                              # LSP 配置
│       │   │   ├── init.lua                     # LSP 入口
│       │   │   ├── install.lua                  # LSP 安装
│       │   │   ├── opts.lua                     # LSP 参数
│       │   │   └── setup.lua                    # LSP 安装前的配置
│       │   ├── others.lua                       # 其他插件配置
│       │   └── xxxx.lua                         # 某一个插件配置
│       ├── init.lua                             # 插件列表
│       └── packerInit.lua                       # Packer插件初始化

自定义

添加 LSP

在添加 Lsp 服务之前, 请确保你安装了 Lsp 服务在本地, 具体可以查看lspconfig. 其次在plugins/lsp/install.lua进行添加.
  1. 如果是直接安装的 Lsp, 只需要在install_normal函数中添加.
  2. 如果有特定的 Lsp, 则需要自行添加.
-- plugins/lsp/install.lua


-- 直接安装的 lsp 示例
local install_normal = function(lspconfig)
  -- 添加 pyright
  local servers = {'pyright'}
  -- ...
end


-- 特定的Lsp
-- 可查看 install_server 函数

自定义添加插件

  1. 在plugins/init.lua中添加插件.
  2. 在core/default_config.lua添加插件配置参数.
  3. 在core/mappings.lua添加插件快捷键(如果需要).
-- plugins/init.lua
use({
  '插件名',
  config = function()
    -- 添加插件的配置
    -- require('plugins.configs.插件名.lua')
  end,
  setup = function()
    -- 插件的前置函数, 一般用来添加键位
    -- require('core.mappings').插件名()
  end,
  -- 其他配置
})


-- core/default_config.lua
-- 插件配置
M.plugins = {
  '插件名' = { }
}
-- 插件键位常量
M.mappings.plugins = {
  '插件名' = { }
}


-- core/mappings.lua
M.'插件名' = function()
-- 添加键位
end

插件列表

你可以在core/default_config.lua中进行禁用.
M.plugins = {
  status = {
    nvimtree = false -- 禁用nvimtree
  }
}

功能插件

UI 插件

为什么不用 vscode ?

  1. 当习惯了 vim 之后, 双手可以不用离开键盘去打字真的很舒服, 它不会打乱你的思考逻辑, 特别是如果你有自己的一套工作流, 它的速度会想象不到的快.
  2. vscode + nvim, 我之前尝试过, 但是这样子你得去尝试解决 vscode 键位冲突, 还得去学习 vscode 额外的配置等等一系列操作, 这个成本是很高的.

感谢

  1. LunarVim
  2. Neovim-from-scratch
  3. VapourNvim
  4. NvChad
  5. Neovim IDE from Scratch with ChrisAtMachine
  6. Neovim Lua From Scratch with Neil Sabde