> 技术文档 > LazyVim 加载顺序

LazyVim 加载顺序

在 LazyVim 中,加载顺序是精心设计的,遵循特定的层次结构。理解这个顺序对于解决配置问题至关重要:

LazyVim 加载顺序详解(从先到后)

  1. init.lua 核心初始化

    • 位置:~/.config/nvim/init.lua
    • 作用:设置基本路径和全局选项
    • 典型内容:
      vim.g.mapleader = \" \"require(\"config.lazy\")
  2. Lazy 插件管理器设置

    • 位置:~/.config/nvim/lua/config/lazy.lua
    • 作用:初始化 lazy.nvim 并定义插件规范
    • 关键结构:
      return { spec = { { import = \"plugins\" }, -- 加载 plugins 目录 { import = \"plugins.extras\" }, -- 加载额外插件 }, defaults = { lazy = true }, -- 全局延迟加载设置 performance = { ... } -- 性能优化设置}
  3. 插件规范加载(按字母顺序)

    • 位置:~/.config/nvim/lua/plugins/*.lua
    • 特点:
      • 文件名排序加载(00-core.lua → 99-extra.lua)
      • 每个文件返回插件配置表
      • 示例结构:
        return { \"stevearc/aerial.nvim\", opts = { backends = { \"treesitter\" } }, keys = { ... }}
  4. 运行时配置加载

    • 位置:~/.config/nvim/lua/config/*.lua
    • 特点:
      • 文件名排序加载
      • 可覆盖插件配置
      • 典型内容:
        -- config/aerial.luareturn function() require(\"aerial\").setup({ backends = { \"treesitter\" }, layout = { min_width = 30 } })end
  5. 用户自定义配置

    • 位置:~/.config/nvim/lua/plugin/*.lua (你的 myProfile.lua)
    • 特点:
      • 最后加载,可覆盖所有前面的配置
      • 需要显式导入才会加载

为什么你的配置在 myProfile.lua 没生效?

  1. 未正确导入

    -- 在 lazy.lua 中需要添加导入return { spec = { { import = \"plugins\" }, { import = \"plugin.myProfile\" } -- 添加这行 }}
  2. 加载顺序冲突

    • 如果其他插件文件(如 plugins/aerial.lua)存在,它会优先于你的 myProfile.lua
    • 解决方案:
      -- 在 myProfile.lua 中强制覆盖require(\"aerial\").setup({ backends = { \"treesitter\" }, force = true -- 关键选项})
  3. 文件位置错误

    • 确保路径正确:~/.config/nvim/lua/plugin/myProfile.lua
    • 注意目录名是 plugin (单数) 不是 plugins (复数)

推荐解决方案(任选其一)

方案1:创建专属插件配置

-- ~/.config/nvim/lua/plugins/aerial.luareturn { \"stevearc/aerial.nvim\", opts = { backends = { \"treesitter\" }, layout = { min_width = 30 } }, keys = { ... } -- 你的键位映射}

方案2:在运行时配置覆盖

-- ~/.config/nvim/lua/config/aerial.luareturn function() require(\"aerial\").setup({ backends = { \"treesitter\" }, on_attach = function(bufnr) vim.keymap.set(\"n\", \"a\", \"AerialToggle!\", { buffer = bufnr }) end })end

方案3:修复 myProfile.lua

-- ~/.config/nvim/lua/plugin/myProfile.luavim.schedule(function() -- 确保在插件加载后执行 require(\"aerial\").setup({ backends = { \"treesitter\" }, force = true -- 强制覆盖现有配置 })end)

验证加载顺序

  1. 查看加载日志:
    :Lazy log
  2. 检查配置:
    :Lazy show aerial.nvim
  3. 查看实际配置:
    :lua =vim.inspect(require(\"aerial\")._state.config.backends)

关键提示:LazyVim 中,plugins/ 目录的配置优先于 config/ 目录,而 plugin/ 目录的内容需要显式导入且最后加载。