Vim / Neovim 完全指南 / 19 - 故障排查与性能优化

# Neovim 启动分析
nvim --startuptime startup.log
nvim --startuptime /dev/stdout 2>&1 | tail -20

# 查看总启动时间
head -1 startup.log    # 开始时间
tail -1 startup.log    # 结束时间

# lazy.nvim 内置分析器
:Lazy profile

-- 错误方式：启动即加载
{ "nvim-telescope/telescope.nvim" }

-- 正确方式：按键触发加载
{ "nvim-telescope/telescope.nvim",
    cmd = "Telescope",
    keys = {
        { "<leader>ff", "<cmd>Telescope find_files<cr>" },
    },
}

-- 事件触发加载
{ "numToStr/Comment.nvim",
    event = "BufReadPost",
}

-- 文件类型触发加载
{ "simrat39/rust-tools.nvim",
    ft = "rust",
}

performance = {
    rtp = {
        disabled_plugins = {
            "gzip",
            "tarPlugin",
            "tohtml",
            "tutor",
            "zipPlugin",
            "netrw",
            "netrwPlugin",
        },
    },
},

-- init.lua 中确保顺序正确
vim.g.mapleader = " "          -- 1. Leader 键（必须在插件前）
require("config.options")       -- 2. 基本选项
require("config.lazy")          -- 3. 插件管理器
require("config.keymaps")       -- 4. 快捷键
require("config.autocmds")      -- 5. 自动命令（最后加载）

-- 大文件优化
vim.api.nvim_create_autocmd("BufReadPre", {
    callback = function()
        local file = vim.fn.expand("<afile>")
        local size = vim.fn.getfsize(file)
        if size > 1024 * 1024 then -- 1MB
            vim.opt_local.syntax = ""
            vim.opt_local.foldmethod = "manual"
            vim.opt_local.spell = false
            vim.opt_local.undofile = false
            vim.opt_local.swapfile = false
            vim.b.large_file = true
        end
    end,
})

highlight = {
    enable = true,
    disable = function(lang, buf)
        local max_filesize = 100 * 1024 -- 100KB
        local ok, stats = pcall(vim.loop.fs_stat, vim.api.nvim_buf_get_name(buf))
        if ok and stats and stats.size > max_filesize then
            return true
        end
    end,
},

-- 默认 4000ms 太慢
vim.opt.updatetime = 250

-- 如果有性能问题，可以适当增大
vim.opt.updatetime = 500

# 检查配置语法
nvim --clean  # 无配置启动

# 仅加载特定文件测试
nvim -u minimal.lua

# 最小配置模板（用于排查）
cat > /tmp/minimal.lua << 'EOF'
vim.opt.runtimepath:prepend("~/.local/share/lazy/lazy.nvim")
require("lazy").setup({
    { "folke/which-key.nvim", config = true },
}, { root = "/tmp/lazy" })
EOF

nvim -u /tmp/minimal.lua

-- 查看最近的错误
:messages

-- Lua 执行追踪
:lua require("notify")("test")

-- 打印调试
:lua print(vim.inspect(vim.opt.tabstop:get()))
:lua print(vim.fn.stdpath("config"))
:lua print(vim.fn.stdpath("data"))

:LspInfo                    " 查看 LSP 状态
:LspLog                     " 查看 LSP 日志
:lua print(vim.lsp.get_active_clients())  " 列出活跃客户端
:MasonLog                   " Mason 日志

" 检查 LSP 是否正确连接
:lua vim.lsp.buf.execute_command({ command = '...' })

:TSInstallInfo              " 查看解析器安装状态
:TSHighlightCapturesUnderCursor  " 查看当前高亮组
:TSModuleInfo               " 查看模块状态
:checkhealth nvim-treesitter  " 健康检查

" 禁用所有插件测试
nvim --noplugin

" 逐个禁用插件排查
" 在 lazy.nvim 中临时设置 enabled = false

" 查看插件加载顺序
:Lazy profile

:checkhealth              " 全部健康检查
:checkhealth vim.lsp      " LSP 检查
:checkhealth nvim-treesitter  " Tree-sitter 检查
:checkhealth telescope    " Telescope 检查

-- 定期清理未使用缓冲区
vim.api.nvim_create_autocmd("BufHidden", {
    callback = function(event)
        if not event.file:match("^%w+://") and vim.bo[event.buf].buftype ~= "nofile" then
            vim.schedule(function()
                pcall(vim.api.nvim_buf_delete, event.buf, { force = false })
            end)
        end
    end,
})

" ShaDa（Shared Data）文件存储：
" - 命令历史
" - 搜索历史
" - 寄存器内容
" - 标记位置
" - jumplist

" ShaDa 文件位置
" Linux: ~/.local/state/nvim/shada/
" macOS: ~/.local/state/nvim/shada/

" 重置 ShaDa
" 删除文件后重启 Neovim