安装LazyVim包管理器时遇lazy模块缺失错误求助

环境信息 #

• NeoVim版本：v0.8.3
• Lua版本：5.4.4

错误详情 #

Error detected while processing /home/eugen/.config/nvim/init.lua:
E5113: Error while calling lua chunk: /home/eugen/.config/nvim/lua/config/lazy.lua:9: module 'lazy' not found:
        no field package.preload['lazy']
        no file './lazy.lua'
        no file '/home/runner/work/neovim/neovim/.deps/usr/share/luajit-2.1.0-beta3/lazy.lua'
        no file '/usr/local/share/lua/5.1/lazy.lua'
        no file '/usr/local/share/lua/5.1/lazy/init.lua'
        no file '/home/runner/work/neovim/neovim/.deps/usr/share/lua/5.1/lazy.lua'
        no file '/home/runner/work/neovim/neovim/.deps/usr/share/lua/5.1/lazy/init.lua'
        no file './lazy.so'
        no file '/usr/local/lib/lua/5.1/lazy.so'
        no file '/home/runner/work/neovim/neovim/.deps/usr/lib/lua/5.1/lazy.so'
        no file '/usr/local/lib/lua/5.1/loadall.so'
stack traceback:
        [C]: in function 'require'
        /home/eugen/.config/nvim/lua/config/lazy.lua:9: in main chunk
        [C]: in function 'require'
        /home/eugen/.config/nvim/init.lua:2: in main chunk
Press ENTER or type command to continue

解决方案 #

1. 清理旧配置（可选但推荐） #

如果之前多次安装失败，残留配置可能引发问题，先彻底清理：

rm -rf ~/.config/nvim
rm -rf ~/.local/share/nvim/lazy

2. 使用官方Starter模板快速安装（最省心） #

官方Starter模板已配置好lazy.nvim的加载逻辑，直接克隆即可：

git clone https://github.com/LazyVim/starter ~/.config/nvim
# 可选：删除模板自带的git仓库，方便自行管理配置
rm -rf ~/.config/nvim/.git

完成后启动NeoVim，lazy.nvim会自动完成剩余安装流程。

3. 手动配置lazy.nvim（适合自定义场景） #

若不想使用Starter模板，手动确保lazy.nvim被正确安装并加载：

步骤1：安装lazy.nvim

创建指定目录并克隆仓库：

mkdir -p ~/.local/share/nvim/lazy
git clone https://github.com/folke/lazy.nvim.git ~/.local/share/nvim/lazy/lazy.nvim

步骤2：检查加载逻辑

打开~/.config/nvim/lua/config/lazy.lua，确保文件开头包含以下代码（必须放在require("lazy").setup(...)之前）：

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",
    "https://github.com/folke/lazy.nvim.git",
    "--branch=stable",
    lazypath,
  })
end
vim.opt.rtp:prepend(lazypath)

这段代码会自动检查lazy.nvim是否存在，缺失时自动克隆安装。

4. 检查依赖与版本 #

• 确保系统已安装git：执行git --version验证，未安装则通过包管理器安装（如Ubuntu：sudo apt install git）。
• 虽然你的NeoVim v0.8.3满足LazyVim最低要求（v0.8.0），若问题仍存在，建议升级到v0.9.x稳定版，规避潜在的版本兼容问题。

验证 #

完成上述步骤后启动NeoVim，若不再出现模块缺失错误，说明安装成功，可开始配置LazyVim插件。

内容的提问来源于stack exchange，提问作者anon