Neovim，要尝一口不？

Neovim 风评很好，我机器上其实早装了它来替代 vim。只不过这两年用 vscode 较多，冷落了它，除了偶尔改改配置文件，很少用。难得大过年的有点儿空，就来倒腾它一下子，最终效果如下。

基础配置

从 0.5 版开始，Neovim 允许使用 Lua 代替 VimL 作为配置语言，所以这里也直接从 init.lua 开始了。

mkdir -p ~/.config/nvimtouch ~/.config/nvim/init.lua

打开此文件，开始配置。

nvim ~/.config/nvim/init.lua

先设置一下缩进，默认是 8 个字符，改为 4 个字符且按 tab 键自动补空格：

vim.g.shiftround = truevim.bo.expandtab = truevim.bo.shiftwidth = 4vim.bo.softtabstop = 4vim.bo.tabstop = 4

再来显示下行号及右边界警示线。右边界一般建议为 80，即代码超过 80 个字符应该注意换行。对现在的屏幕分辨率来说，80 其实有些窄，可以设为 120。

vim.wo.number = truevim.wo.colorcolumn = "120"

neovim 默认打开了不少之前在 vim 中需要单独设置的选项，比如说自动缩进、文件类型检测、语法高亮等等。有了上面这几行，基础的配置差不多就够了，其它的安装插件后再调整。

插件管理

选用 lazy，与 packer 相比，它不需要编译、更快、界面也好看些，还有其它优点，不罗列了。总之，就是它了。

local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"if not vim.loop.fs_stat(lazypath) then  vim.fn.system({    "git",    "clone",    "--filter=blob:none",    "git@github.com:folke/lazy.nvim.git",    "--branch=stable",    lazypath,  })endvim.opt.rtp:prepend(lazypath)

注意与官方文档相比，我把 clone 地址由 https://github.com/folke/lazy.nvim.git 改为了 git@github.com:folke/lazy.nvim.git，原因你知道的，国内访问 Github 网址抽风，改用后者要好一些。

接着就是让 lazy 起作用了，加入如下配置：

require("lazy").setup({-- 插件写这里}, {    git = {        url_format = "git@github.com:%s"    }})

以上同样加了些针对 git 下载路径的自定义设置，原因同上。

需要特别说明的是，为了节省篇幅，后续凡是提到安装插件的，相关代码都是追加到如下注释的地方：

-- 以上省略require("lazy").setup({-- 插件相关配置在这里追加}, {-- 以下省略

然后输入如下命令就可以打开安装界面进行安装了：

:Lazy

配色方案

配色方案也是插件，可选的太多了，我使用 Nightfox。它本身又包含了多套方案，如下用的是 nordfox：

    {        "EdenEast/nightfox.nvim",        lazy = false,        priority = 1000,        config = function()            vim.cmd([[colorscheme nordfox]])        end,    },

安装之后，界面长这样：

还是很好看的。

字体与图标

首先打开 NERD FONTS，找一款你喜欢的编程字体装进系统里，然后设置你的终端使用该字体。接下来安装插件 nvim-web-devicons：

    "nvim-tree/nvim-web-devicons",

以上操作目的是为了给 neovim 提供图标支撑，目前暂时看不到变化，算是为后续做些准备工作。

状态栏

选用 lualine 插件：

    {        "nvim-lualine/lualine.nvim",        opts = {            options = {                section_separators = '',                component_separators = ''            }        }    },

其实可以只保留如下一行，显示效果可能还好一些。我个人偏爱简洁样式，用上述选项是为了去掉分隔符。

    "nvim-lualine/lualine.nvim",

文件管理

选 nvim-tree，用的人多，比较活跃。

    {        "nvim-tree/nvim-tree.lua",        config = function()            vim.g.loaded_netrw = 1            vim.g.loaded_netrwPlugin = 1            vim.g.termguicolors = true            require("nvim-tree").setup({                sort_by = "case_sensitive",            })        end,    },

安装后，输入命令：

:NvimTreeToggle

就会打开文件树，如下图：

但是每次输入命令打开关闭文件树不太爽，用快捷键就好多了。

快捷键

先定义一下全局的快捷起始键，通常用空格或逗号，如下定义为逗号：

vim.g.mapleader = ","

如下定义 ,+空格 取消搜索高亮：

vim.keymap.set("n", "", "nohlsearch", { silent = true })

快捷键用熟了很好，刚定义时容易忘。想要提示的话，可以用 which-key 插件来定义快捷键。

    {        "folke/which-key.nvim",        config = function()            vim.o.timeout = true            vim.o.timeoutlen = 300            local wk = require("which-key")            -- 快捷键在这里定义            wk.setup()        end,    },

注意其中的注释，后续对快捷键定义如无特殊说明，都写在上述注释所在的位置。

现在可以试一下了，按下 Ctrl-W 组合键，效果如下：

Amazing，比较带劲是不是？

接下来注册自己想要的快捷键，比如：

            wk.register({                [""] = { "nohlsearch", "取消搜索高亮" },                ["d"] = { "NvimTreeToggle", "显示/隐藏目录树" },            }, { prefix = "" })

这样就可以用 ,+d 来切换目录树的显示了。顺便的，当使用 / 或 ? 搜索时，匹配项会高亮显示，现在可以使用 ,+空格 来取消高亮了。如果按下 , 键，则会弹出以上快捷键的说明。相当不错！

多文档

vim/neovim 有两种模式支持多文档编辑：标签页或缓冲区。这里选择使用缓冲区，bufferline 插件可以展示多个缓冲区的文档标签：

    {        "akinsho/bufferline.nvim",        tag = "v3.*",        config = function()            vim.g.termguicolors = true            require("bufferline").setup()        end,    },

试下效果吧。用 ,+d 打开目录树，按 j 或 k 选中个文件，再按 o 或直接回车就打开了，注意上方多出来的标签页。

试试用鼠标点击标签页以及其中的关闭按纽，功能正是你想要的，对吧？不过在 vim 中用鼠标似乎有些 low，用命令 :bn、:bp 算是正常途径。也可以定义快捷键，如下：

            vim.keymap.set("n", "bp", "BufferLineCyclePrev", { silent = true })            vim.keymap.set("n", "bn", "BufferLineCycleNext", { silent = true })            vim.keymap.set("n", "bd", "bd", { silent = true })

配置到现在，乍一看很象回事了。但是用来写代码的话，还不太够，所以继续。

参考线及特殊字符

先加两行全局配置，以区分空格与制表符、以及折行与回车换行:

vim.o.listchars = "eol:↵,lead:‧"vim.wo.list = true

然后装个 indent-blankline 插件：

    {    "lukas-reineke/indent-blankline.nvim",    },

代码片断

使用插件 luasnip，与自动完成的集成稍后再说。

    {        "L3MON4D3/LuaSnip",        version = "^1.1.0",        dependencies = {            "rafamadriz/friendly-snippets",        },        config = function()            require("luasnip.loaders.from_vscode").lazy_load()        end,    },

自动完成

从这里开始，进入稍微复杂的配置部分。先来弄自动完成。自动完成的原材料可以来源于当前文档关键字、可以来源于代码片断，当然我们更希望它来源于我们的编程上下文语义，即 LSP 集成。如下是相关插件配置。

    {        "hrsh7th/nvim-cmp",        dependencies = {            "hrsh7th/cmp-buffer",            "hrsh7th/cmp-path",            "hrsh7th/cmp-nvim-lsp",            "L3MON4D3/LuaSnip",            "saadparwaiz1/cmp_luasnip",        },        config = function()            local cmp = require("cmp")            cmp.setup({                snippet = {                    expand = function(args)                        require("luasnip").lsp_expand(args.body)                    end,                },                mapping = cmp.mapping.preset.insert({                    [''] = cmp.mapping.scroll_docs(-4),                    [''] = cmp.mapping.scroll_docs(4),                    [''] = cmp.mapping.complete(),                    [''] = cmp.mapping.abort(),                    [''] = cmp.mapping.confirm({ select = true }),                }),                sources = cmp.config.sources({                    { name = 'nvim_lsp' },                    { name = 'luasnip' },                }, {                    { name = 'buffer' },                    { name = "path" },                }),            })        end,    },

看起来比较复杂，对吧？简单解释一下：

• 自动完成使用了 nvim-cmp 插件；
• 提示内容可以来源于当前文档、路径、代码片断及上下文语义；
• 定义了几个快捷键；

上下文语义（LSP）

可能是最复杂的部分，配置如下：

    {        "neovim/nvim-lspconfig",        dependencies = {            "williamboman/mason.nvim",            "williamboman/mason-lspconfig.nvim",            "hrsh7th/cmp-nvim-lsp",        },        config = function()            require("mason-lspconfig").setup({                ensure_installed = {                    "bashls",                    "clangd",                    "denols",                    "pyright",                    "rust_analyzer",                },            })            local capabilities = require('cmp_nvim_lsp').default_capabilities()            local lspcfg = require("lspconfig")            lspcfg.bashls.setup({                capabilities = capabilities,                on_attach = on_attach            })            lspcfg.clangd.setup({                capabilities = capabilities,                on_attach = on_attach            })            lspcfg.denols.setup({                capabilities = capabilities,                on_attach = on_attach            })            lspcfg.pyright.setup({                capabilities = capabilities,                on_attach = on_attach            })            lspcfg.rust_analyzer.setup({                capabilities = capabilities,                on_attach = on_attach            })        end,    },

仍然是最简单的解释一下：

• 使用了 nvim-lspconfig 插件来做 LSP 的配置；
• 不同的编程语言要安装不同的语言服务，使用 mason 来统一管理这些语言服务组件；
• 自动安装 bash、c/c++、js/ts、python、rust 语言服务；
• 集成上述编程语言的语义化自动完成功能；

其中有个 on_attach 在给出的配置代码中暂未给出，是因为这是个公用函数，下文的代码格式化也会用到，所以稍后再描述。

格式化及诊断

这两项内容均使用 null-ls 插件实现，配置如下：

    {        "jose-elias-alvarez/null-ls.nvim",        dependencies = {            "nvim-lua/plenary.nvim",        },        config = function()            local nl = require("null-ls")            local sources = {                nl.builtins.diagnostics.eslint_d,                nl.builtins.diagnostics.ruff,                nl.builtins.formatting.beautysh,                nl.builtins.formatting.black,                nl.builtins.formatting.clang_format,                nl.builtins.formatting.prettierd,                nl.builtins.formatting.rustfmt,                nl.builtins.formatting.sql_formatter,            }            nl.setup({                sources = sources,                on_attach = on_attach,            })        end,    },

很明显，诊断与格式化也都与编程语言相关，同样依赖一些第三方组件。尽管上述配置没用明确给出，也可以通过 mason 管理，之前已经安装过些插件。输入 :Mason 即可打开其界面如下：

可以看到我已经安装了 LSP 及格式化与诊断相关的几个组件。

是时候说一下 on_attach 了，其代码如下：

local on_attach = function(client, bufnr)    vim.api.nvim_buf_set_option(bufnr, 'omnifunc', 'v:lua.vim.lsp.omnifunc')    local bufopts = { noremap=true, silent=true, buffer=bufnr }    vim.keymap.set('n', 'gD', vim.lsp.buf.declaration, bufopts)    vim.keymap.set('n', 'gd', vim.lsp.buf.definition, bufopts)    vim.keymap.set('n', 'gi', vim.lsp.buf.implementation, bufopts)    vim.keymap.set('n', 'gr', vim.lsp.buf.references, bufopts)    vim.keymap.set('n', 'K', vim.lsp.buf.hover, bufopts)    vim.keymap.set('n', '', vim.lsp.buf.signature_help, bufopts)    vim.keymap.set('n', 'wa', vim.lsp.buf.add_workspace_folder, bufopts)    vim.keymap.set('n', 'wr', vim.lsp.buf.remove_workspace_folder, bufopts)    vim.keymap.set('n', 'wl', function()        print(vim.inspect(vim.lsp.buf.list_workspace_folders()))    end, bufopts)    vim.keymap.set('n', 'D', vim.lsp.buf.type_definition, bufopts)    vim.keymap.set('n', 'rn', vim.lsp.buf.rename, bufopts)    vim.keymap.set('n', 'ca', vim.lsp.buf.code_action, bufopts)    vim.keymap.set('n', 'f', function()        vim.lsp.buf.format { async = true }    end, bufopts)    local augroup = vim.api.nvim_create_augroup("LspFormatting", {})    if client.supports_method("textDocument/formatting") then        vim.api.nvim_clear_autocmds({ group = augroup, buffer = bufnr })        vim.api.nvim_create_autocmd("BufWritePre", {            group = augroup,            buffer = bufnr,            callback = function()                vim.lsp.buf.format({                    filter = function(client)                        return client.name == "null-ls"                    end,                    bufnr = bufnr,                })            end,        })    endend

主要是定义了一些快捷键，例如：

• gd 可以跳转至关键字定义；
• gi 可以跳转至类型实现；
• ,D 可以跳转至类型定义；
• ,f 代码格式化；
• 保存时自动进行代码格式化；

其它

• 注释，使用插件：comment.nvim；
• 错误列表，使用插件：trouble.nvim；

完整配置

vim.o.listchars = "eol:↵,lead:‧"vim.wo.list = truevim.wo.number = truevim.wo.signcolumn = "yes"vim.wo.colorcolumn = "80"vim.g.shiftround = truevim.bo.expandtab = truevim.bo.shiftwidth = 4vim.bo.softtabstop = 4vim.bo.tabstop = 4vim.g.termguicolors = truevim.g.completeopt = "menu,menuone,noselect"vim.g.mapleader = ","vim.keymap.set("n", "", "nohlsearch", { silent = true })-- vim.lsp.set_log_level("debug")local on_attach = function(client, bufnr)    vim.api.nvim_buf_set_option(bufnr, 'omnifunc', 'v:lua.vim.lsp.omnifunc')    local bufopts = { noremap=true, silent=true, buffer=bufnr }    vim.keymap.set('n', 'gD', vim.lsp.buf.declaration, bufopts)    vim.keymap.set('n', 'gd', vim.lsp.buf.definition, bufopts)    vim.keymap.set('n', 'gi', vim.lsp.buf.implementation, bufopts)    vim.keymap.set('n', 'gr', vim.lsp.buf.references, bufopts)    vim.keymap.set('n', 'K', vim.lsp.buf.hover, bufopts)    vim.keymap.set('n', '', vim.lsp.buf.signature_help, bufopts)    vim.keymap.set('n', 'wa', vim.lsp.buf.add_workspace_folder, bufopts)    vim.keymap.set('n', 'wr', vim.lsp.buf.remove_workspace_folder, bufopts)    vim.keymap.set('n', 'wl', function()        print(vim.inspect(vim.lsp.buf.list_workspace_folders()))    end, bufopts)    vim.keymap.set('n', 'D', vim.lsp.buf.type_definition, bufopts)    vim.keymap.set('n', 'rn', vim.lsp.buf.rename, bufopts)    vim.keymap.set('n', 'ca', vim.lsp.buf.code_action, bufopts)    vim.keymap.set('n', 'f', function()        vim.lsp.buf.format { async = true }    end, bufopts)    local augroup = vim.api.nvim_create_augroup("LspFormatting", {})    if client.supports_method("textDocument/formatting") then        vim.api.nvim_clear_autocmds({ group = augroup, buffer = bufnr })        vim.api.nvim_create_autocmd("BufWritePre", {            group = augroup,            buffer = bufnr,            callback = function()                vim.lsp.buf.format({                    filter = function(client)                        return client.name == "null-ls"                    end,                    bufnr = bufnr,                })            end,        })    endendlocal lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"if not vim.loop.fs_stat(lazypath) then    vim.fn.system({        "git",        "clone",        "--filter=blob:none",        "git@github.com:folke/lazy.nvim.git",        "--branch=stable",        lazypath,    })endvim.opt.rtp:prepend(lazypath)require("lazy").setup({    "nvim-tree/nvim-web-devicons",    {        "EdenEast/nightfox.nvim",        lazy = false,        priority = 1000,        config = function()            vim.cmd([[colorscheme nordfox]])        end,    },    {        "nvim-tree/nvim-tree.lua",        config = function()            vim.g.loaded_netrw = 1            vim.g.loaded_netrwPlugin = 1            require("nvim-tree").setup({                sort_by = "case_sensitive",            })            vim.keymap.set("n", "d", "NvimTreeToggle", { silent = true })        end,    },    {        "nvim-lualine/lualine.nvim",        dependencies = {            "nvim-tree/nvim-web-devicons",        },        opts = {            options = {                section_separators = "",                component_separators = "⁞",            },        },    },    {        "akinsho/bufferline.nvim",        version = "^3.1.0",        config = function()            require("bufferline").setup()            vim.keymap.set("n", "bp", "BufferLineCyclePrev", { silent = true })            vim.keymap.set("n", "bn", "BufferLineCycleNext", { silent = true })            vim.keymap.set("n", "bd", "bd", { silent = true })        end,    },    {        "lukas-reineke/indent-blankline.nvim",        opts = {            show_end_of_line = true,            space_char_blankline = " ",        },    },    {        "L3MON4D3/LuaSnip",        version = "^1.1.0",        dependencies = {            "rafamadriz/friendly-snippets",        },        config = function()            require("luasnip.loaders.from_vscode").lazy_load()        end,    },    {        "hrsh7th/nvim-cmp",        dependencies = {            "hrsh7th/cmp-buffer",            "hrsh7th/cmp-path",            "hrsh7th/cmp-nvim-lsp",            "L3MON4D3/LuaSnip",            "saadparwaiz1/cmp_luasnip",        },        config = function()            local cmp = require("cmp")            cmp.setup({                snippet = {                    expand = function(args)                        require("luasnip").lsp_expand(args.body)                    end,                },                mapping = cmp.mapping.preset.insert({                    [''] = cmp.mapping.scroll_docs(-4),                    [''] = cmp.mapping.scroll_docs(4),                    [''] = cmp.mapping.complete(),                    [''] = cmp.mapping.abort(),                    [''] = cmp.mapping.confirm({ select = true }),                }),                sources = cmp.config.sources({                    { name = 'nvim_lsp' },                    { name = 'luasnip' },                }, {                    { name = 'buffer' },                    { name = "path" },                }),            })        end,    },    {        "williamboman/mason.nvim",        opts = {            ui = {                check_outdated_packages_on_open = false,            },        },    },    {        "neovim/nvim-lspconfig",        dependencies = {            "williamboman/mason.nvim",            "williamboman/mason-lspconfig.nvim",            "hrsh7th/cmp-nvim-lsp",        },        config = function()            require("mason-lspconfig").setup({                ensure_installed = {                    "bashls",                    "clangd",                    "denols",                    "pyright",                    "rust_analyzer",                },            })            local capabilities = require('cmp_nvim_lsp').default_capabilities()            local lspcfg = require("lspconfig")            lspcfg.bashls.setup({                capabilities = capabilities,                on_attach = on_attach            })            lspcfg.clangd.setup({                capabilities = capabilities,                on_attach = on_attach            })            lspcfg.denols.setup({                capabilities = capabilities,                on_attach = on_attach            })            lspcfg.pyright.setup({                capabilities = capabilities,                on_attach = on_attach            })            lspcfg.rust_analyzer.setup({                capabilities = capabilities,                on_attach = on_attach            })        end,    },    {        "jose-elias-alvarez/null-ls.nvim",        dependencies = {            "nvim-lua/plenary.nvim",        },        config = function()            local nl = require("null-ls")            local sources = {                nl.builtins.diagnostics.eslint_d,                nl.builtins.diagnostics.ruff,                nl.builtins.formatting.beautysh,                nl.builtins.formatting.black,                nl.builtins.formatting.clang_format,                nl.builtins.formatting.prettierd,                nl.builtins.formatting.rustfmt,                nl.builtins.formatting.sql_formatter,            }            nl.setup({                sources = sources,                on_attach = on_attach,            })        end,    },    {        'numToStr/Comment.nvim',        config = true,    },    {        "folke/trouble.nvim",        dependencies = {            "nvim-tree/nvim-web-devicons",        },        config = true,    },}, {    git = {        url_format = "git@github.com:%s",    },})