Neovim：Vim-fork 现代化编辑器完全指南

// Neovim 事件循环简化模型
while (!quit) {
    // 1. 等待事件（IO、Timer、RPC 等）
    event = wait_for_events();
    
    // 2. 分发事件到对应处理器
    dispatch(event);
    
    // 3. 处理 UI 更新
    if (has_ui_updates()) {
        send_ui_refresh();
    }
}

# Python 调用 Neovim API 示例
import msgpack
import socket

# 连接到 Neovim
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
sock.connect(('127.0.0.1', 6666)

# 发送 RPC 请求
request = {
    'id': 1,
    'method': 'nvim_eval',
    'params': ['1 + 1']
}
sock.send(msgpack.packb(request))

# 接收响应
response = msgpack.unpackb(sock.recv(1024))
print(response)  # {'id': 1, 'result': 2, 'error': None}

// event/loop.h
typedef struct {
    Loop loop;                    // 主事件循环
    Multiplexer *events;          // 事件多路复用
    Queue *thread_events;         // 线程间通信
    TimerPool *timer_pool;        // 定时器池
} Loop;

// 事件类型
typedef enum {
    EVENT_IO,
    EVENT_TIMER,
    EVENT_CHILD,
    EVENT_RPC,
    EVENT_UI,
} EventType;

-- init.lua 示例
local api = vim.api

-- 调用 Neovim API
api.nvim_set_option('number', true)
api.nvim_set_option(' relativenumber', true)

-- 定义命令
vim.cmd([[
    command! HelloWorld echo "Hello from Neovim!"
]])

-- 键映射
vim.keymap.set('n', '<leader>f', ':FzfLua files<CR>')

# Debian/Ubuntu
sudo apt install neovim

# Fedora
sudo dnf install neovim

# Arch Linux
sudo pacman -S neovim

# Void Linux
sudo xbps-install neovim

# 1. 克隆仓库
git clone https://github.com/neovim/neovim
cd neovim

# 2. 安装依赖（Ubuntu/Debian）
sudo apt-get update
sudo apt-get install -y \
    cmake \
    ninja-build \
    gettext \
    libtool \
    libtool-bin \
    autoconf \
    automake \
    pkg-config \
    curl \
    unzip

# 3. 构建（Release 模式）
make CMAKE_BUILD_TYPE=RelWithDebInfo

# 4. 安装到系统
sudo make install

# 5. 验证安装
nvim --version

-- init.lua - Neovim 基础配置

-- 设置 leader 键
vim.g.mapleader = ' '
vim.g.maplocalleader = ' '

-- 基础选项
vim.opt.number = true           -- 显示行号
vim.opt.relativenumber = true   -- 显示相对行号
vim.opt.cursorline = true       -- 高亮当前行
vim.opt.termguicolors = true   -- 启用 24 位颜色
vim.opt.signcolumn = 'yes'      -- 显示符号列
vim.opt.splitright = true       -- 水平分割右侧
vim.opt.splitbelow = true       -- 垂直分割下方
vim.opt.mouse = 'a'            -- 启用鼠标

-- 缩进
vim.opt.expandtab = true        -- 使用空格代替 Tab
vim.opt.shiftwidth = 4          -- 缩进宽度
vim.opt.tabstop = 4             -- Tab 宽度
vim.opt.softtabstop = 4         -- 软 Tab 宽度

-- 搜索
vim.opt.ignorecase = true       -- 忽略大小写
vim.opt.smartcase = true        -- 智能大小写
vim.opt.hlsearch = true         -- 高亮搜索结果
vim.opt.incsearch = true        -- 增量搜索

-- 性能优化
vim.opt.hidden = true           -- 隐藏 Buffer 而不关闭
vim.opt.autoread = true         -- 文件外部修改时自动读取
vim.opt.writebackup = false      -- 关闭备份文件
vim.opt.undofile = true         -- 持久撤销历史

-- 自动命令
vim.api.nvim_create_autocmd('FileType', {
    pattern = 'lua',
    callback = function()
        vim.opt_local.tabstop = 2
        vim.opt_local.shiftwidth = 2
    end
})

-- 使用 lazy.nvim 管理插件
require('lazy').setup({
    -- 主题
    { 'folke/tokyonight.nvim' },
    
    -- 文件树
    {
        'nvim-tree/nvim-tree.lua',
        requires = 'nvim-tree/nvim-web-devicons',
    },
    
    -- 模糊搜索
    { 'nvim-telescope/telescope.nvim' },
    
    -- LSP 支持
    { 'neovim/nvim-lspconfig' },
    
    -- 自动补全
    { 'hrsh7th/nvim-cmp' },
    
    -- 语法高亮
    { 'nvim-treesitter/nvim-treesitter' },
})

-- plugin/hello.lua
local M = {}

function M.say_hello()
    print('Hello from Neovim plugin!')
end

-- 带 UI 的 hello
function M.hello_with_ui()
    vim.cmd([[
       echohl Title
        echo "Hello from Neovim!"
        echohl None
    ]])
end

return M

-- init.lua - LSP 配置
local lspconfig = require('lspconfig')

-- Python LSP (pyright)
lspconfig.pyright.setup({
    settings = {
        python = {
            analysis = {
                typeCheckingMode = 'basic'
            }
        }
    }
})

-- TypeScript LSP
lspconfig.tsserver.setup({})

-- Lua LSP
lspconfig.lua_ls.setup({
    settings = {
        Lua = {
            runtime = {
                version = 'Lua 5.4'
            }
        }
    }
})

# 打开终端（默认浮动窗口）
:terminal

# 水平分割窗口打开
:split | terminal

# 垂直分割窗口打开
:vsplit | terminal

# 在当前 buffer 运行命令
:!make test

-- 使用 Neovim 异步 API
local job = vim.fn.jobstart(
    {'python', '-c', 'import time; time.sleep(5); print("done")'},
    {
        on_stdout = function(_, data)
            print('stdout: ' .. vim.fn.join(data, ''))
        end,
        on_stderr = function(_, data)
            vim.api.nvim_err_writeln('stderr: ' .. vim.fn.join(data, ''))
        end,
        on_exit = function(_, code)
            print('exited with code: ' .. code)
        end,
        stdout_buffered = true,
    }
)

import pynvim

@pynvim.plugin
class MyPlugin:
    def __init__(self, nvim):
        self.nvim = nvim
    
    @pynvim.command('HelloWorld', range='')
    def hello(self, args, range):
        self.nvim.command('echo "Hello from Python plugin!"')
    
    @pynvim.function('GetBufferCount')
    def get_buffer_count(self, args):
        return len(self.nvim.buffers)

-- init.lua - 性能优化配置

-- 延迟加载插件
require('lazy').setup({
    -- 键盘快捷键触发加载
    { 'nvim-telescope/telescope.nvim', keys = { '<leader>f' } },
    
    -- 文件类型触发加载
    { 'nvim-treesitter/nvim-treesitter', ft = { 'c', 'lua', 'python' } },
}, {
    performance = {
        rtp = {
            reset = false,
            paths = {},
            disabled_plugins = {
                'gzip',
                'tarPlugin',
                'tohtml',
                'tutor',
                'zipPlugin',
            },
        },
    },
})

-- ~/.config/nvim/plugin/remote.lua
-- 允许外部进程调用 Neovim API

vim.rpcstart('python3', {
    '-c',
    [[
import pynvim
@pynvim.plugin
class RemotePlugin:
    @pynvim.function('GetNeovimVersion')
    def get_version(self, args):
        return 'Neovim ' .. pynvim.call('nvim_version')['major']
]],
})

# 启动调试模式
nvim --log-level=DEBUG

# 查看日志
nvim --log

# 检查健康状态
:checkhealth

# 查看 API 调用
:verbose vim.api.nvim_set_option(...)