nvim

安装

可在 GitHub Release 中下载二进制版本，并设置环境变量。

export PATH="$HOME/neovim/bin:$PATH"

使用 Homebrew 安装需要下载依赖和编译，速度较慢，且只能下载部分版本。

brew install neovim

插件管理

推荐使用 lazy.nvim。

lazy.nvim：Neovim 专用，启动快，延迟加载，使用 Lua 编写。
vim-plug：Vim/Neovim 通用，历史悠久，使用 Vimscript 编写。
packer.nvim：不再维护（2023 年 8 月）。

lazy.nvim

官方安装文档

lazy.folke.io/installation

配置目录

不同系统的配置目录如下。

~/.config/nvim

~\AppData\Local\nvim

结构化配置

可在 ~/.config/nvim/lua/plugins/ 中创建插件的配置文件。

~/.config/nvim
├── lua
│   ├── config
│   │   └── lazy.lua
│   └── plugins
│       ├── spec1.lua
│       ├── **
│       └── spec2.lua
└── init.lua

require("config.lazy")

注意

下面的 lazyrepo 是 GitHub 仓库，网络不通时可使用代理。

-- Bootstrap lazy.nvim
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
if not (vim.uv or vim.loop).fs_stat(lazypath) then
  local lazyrepo = "https://github.com/folke/lazy.nvim.git"
  local out = vim.fn.system({ "git", "clone", "--filter=blob:none", "--branch=stable", lazyrepo, lazypath })
  if vim.v.shell_error ~= 0 then
    vim.api.nvim_echo({
      { "Failed to clone lazy.nvim:\n", "ErrorMsg" },
      { out, "WarningMsg" },
      { "\nPress any key to exit..." },
    }, true, {})
    vim.fn.getchar()
    os.exit(1)
  end
end
vim.opt.rtp:prepend(lazypath)

-- Make sure to setup `mapleader` and `maplocalleader` before
-- loading lazy.nvim so that mappings are correct.
-- This is also a good place to setup other settings (vim.opt)
vim.g.mapleader = " "
vim.g.maplocalleader = "\\"

-- Setup lazy.nvim
require("lazy").setup({
  spec = {
    -- import your plugins
    { import = "plugins" },
  },
  -- Configure any other settings here. See the documentation for more details.
  -- colorscheme that will be used when installing plugins.
  install = { colorscheme = { "habamax" } },
  -- automatically check for plugin updates
  checker = { enabled = true },
})

自动化脚本

bash init.sh

#!/usr/bin/env bash

# create dir
mkdir -p ~/.config/nvim/lua/config
mkdir -p ~/.config/nvim/lua/plugins

# init.lua
cat <<'EOL' > ~/.config/nvim/init.lua
require("config.lazy")
EOL

# lazy.lua
cat <<'EOL' > ~/.config/nvim/lua/config/lazy.lua
-- Bootstrap lazy.nvim
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
if not (vim.uv or vim.loop).fs_stat(lazypath) then
  local lazyrepo = "https://github.com/folke/lazy.nvim.git"
  local out = vim.fn.system({ "git", "clone", "--filter=blob:none", "--branch=stable", lazyrepo, lazypath })
  if vim.v.shell_error ~= 0 then
    vim.api.nvim_echo({
      { "Failed to clone lazy.nvim:\n", "ErrorMsg" },
      { out, "WarningMsg" },
      { "\nPress any key to exit..." },
    }, true, {})
    vim.fn.getchar()
    os.exit(1)
  end
end
vim.opt.rtp:prepend(lazypath)

-- Make sure to setup `mapleader` and `maplocalleader` before
-- loading lazy.nvim so that mappings are correct.
-- This is also a good place to setup other settings (vim.opt)
vim.g.mapleader = " "
vim.g.maplocalleader = "\\"

-- Setup lazy.nvim
require("lazy").setup({
  spec = {
    -- import your plugins
    { import = "plugins" },
  },
  -- Configure any other settings here. See the documentation for more details.
  -- colorscheme that will be used when installing plugins.
  install = { colorscheme = { "habamax" } },
  -- automatically check for plugin updates
  checker = { enabled = true },
})
EOL

echo "Init ~/.config/nvim/ done"

nvim-tree

在 ~/.config/nvim/lua/plugins/ 创建 nvim-tree.lua。

return {
  "kyazdani42/nvim-tree.lua",
  dependencies = {
    "kyazdani42/nvim-web-devicons", -- file icon dependency
  },
  config = function()
    require("nvim-tree").setup {}
  end
}

进入 nvim，会自动拉取依赖，也可手动拉取。

:Lazy sync

使用代理

网络不通时，可使用代理。

git config --global url."https://mirror.ghproxy.com/https://github.com/".insteadof https://github.com/

查看代理配置。

git config --global --get-regexp url

删除代理，也可以在 ~/.gitconfig 中删除。

git config --global --unset url.https://mirror.ghproxy.com/https://github.com/

打开文件树

:NvimTreeToggle

图标显示不正常，需要安装字体，并在 iTerm2 中设置字体。

安装字体

Nerd Font

brew install font-hack-nerd-font

配置 iTerm2 字体。

打开 iTerm2。
进入 Preferences > Profiles > Text。
勾选 Use a different font for non-ASCII text。
然后选择你安装的 Nerd Font。
t 表示终端模式。
<esc> 表示新的退出键。
<C-\><C-n> 表示实际的退出键。

nvim-treesitter

return {
  "nvim-treesitter/nvim-treesitter",
  run = ":TSUpdate",
  config = function()
    require("nvim-treesitter.configs").setup {
      ensure_installed = "all", -- Install all parsers or specify a list
      highlight = {
        enable = true, -- Enable highlighting
      },
    }
  end,
}

Monokai 主题

return {
    "tanvirtin/monokai.nvim",
    config = function()
        local monokai = require('monokai')
        local palette = monokai.classic
        monokai.setup {
            palette = {
                base2 = "#000000",
            },
            custom_hlgroups = {
                LineNr = {
                    fg = "gray",
                },
            },
            italics = false
        }
        -- inform nvim-tree to load after monokai.nvim
        vim.api.nvim_exec_autocmds("User", { pattern = "MonokaiLoaded" })
    end
}

注意

nvim-tree 必须在 monokai.nvim 之后加载。

监听事件，确保 nvim-tree 在 monokai.nvim 之后加载。

return {
  "kyazdani42/nvim-tree.lua",
  dependencies = {
    "kyazdani42/nvim-web-devicons", -- icons dependency
  },
  -- Must be loaded after monokai.nvim
  -- Otherwise, the icons color may be wrong
  event = "User MonokaiLoaded",
  config = function()
    require("nvim-tree").setup {
      renderer = {
        icons = {
          show = {
            file = true,
            folder = true,
            git = true,
          },
        },
      },
      filters = {
        dotfiles = true, -- show hidden files if false, hide if true
      },
    }
  end
}

语言服务协议

gopls 是 Go 语言的 LSP(Language Server Protocol) 服务。

go install golang.org/x/tools/gopls@latest

return {
  "neovim/nvim-lspconfig",
  config = function()
    local lspconfig = require("lspconfig")
    lspconfig.gopls.setup {
      settings = {
        gopls = {
          staticcheck = true,
          usePlaceholders = true,
          analyses = {
            unusedparams = true,
            unreachable = true,
          },
        },
      },
      on_attach = function(client, bufnr)
        vim.fn.sign_define("DiagnosticSignError", { text = "", texthl = "" })
        vim.fn.sign_define("DiagnosticSignWarn", { text = "", texthl = "" })
        vim.fn.sign_define("DiagnosticSignInfo", { text = "", texthl = "" })
        vim.fn.sign_define("DiagnosticSignHint", { text = "", texthl = "" })
      end,
    }
  end,
}

DiagnosticSignError 设置为空，否则行号左侧会显示 E 符号，导致布局抖动。

自动补全

nvim-cmp 是 Neovim 的自动补全插件。

return {
  "hrsh7th/nvim-cmp",
  dependencies = {
    "hrsh7th/cmp-nvim-lsp",   -- LSP source for nvim-cmp
    "hrsh7th/cmp-buffer",      -- Buffer completion source
    "hrsh7th/cmp-path",        -- Path completion source
    "hrsh7th/cmp-cmdline",     -- Cmdline completion source
    "hrsh7th/vim-vsnip",       -- Snippet engine
  },
  config = function()
    local cmp = require("cmp")
    cmp.setup({
      snippet = {
        expand = function(args)
          vim.fn["vsnip#anonymous"](args.body) -- For vsnip users.
        end,
      },
      mapping = {
        ['<CR>'] = cmp.mapping.confirm({ select = true }),
        ["<C-j>"] = cmp.mapping.select_next_item(),
        ["<C-k>"] = cmp.mapping.select_prev_item(),
        -- ['<C-e>'] = cmp.mapping.complete(), -- trigger completion
      },
      sources = {
        { name = "nvim_lsp" },
        { name = "buffer" },
        { name = "path" },
      },
    })
  end,
}

常用快捷键

转换窗口：Ctrl+w+h/l
进入目录：Ctrl+]
隐藏文件：Ctrl+h
新建文件：a + 文件名，带 / 表示目录
剪切文件：x
粘贴文件：p
删除文件：d + y
新建终端：:term
缓冲列表：:ls
切换缓冲：:b [num]
左插窗口：Ctrl+v，编号为 a/b
上插窗口：Ctrl+x，编号为 a/b
挂起进程：Ctrl+z
恢复进程：fg

退出终端的插入模式

在 init.lua 中添加。

vim.keymap.set('t', '<esc>', [[<C-\><C-n>]])

配置源码

nvim-plugins

zshrc

用 ChatGPT 写爬虫

Tech

kugarocks

Title here

nvim

安装

插件管理

lazy.nvim

官方安装文档

配置目录

结构化配置

自动化脚本

nvim-tree

使用代理

打开文件树

安装字体

Nerd Font

nvim-treesitter

Monokai 主题

语言服务协议

自动补全

常用快捷键

退出终端的插入模式

配置源码

nvim-plugins

nvim

安装#

插件管理#

lazy.nvim#

官方安装文档

配置目录#

结构化配置#

自动化脚本#

nvim-tree#

使用代理#

打开文件树#

安装字体#

Nerd Font

nvim-treesitter#

Monokai 主题#

语言服务协议#

自动补全#

常用快捷键#

退出终端的插入模式#

配置源码#

nvim-plugins

安装

插件管理

lazy.nvim

配置目录

结构化配置

自动化脚本

nvim-tree

使用代理

打开文件树

安装字体

nvim-treesitter

Monokai 主题

语言服务协议

自动补全

常用快捷键

退出终端的插入模式

配置源码