Neovim配置报错：module 'lazy' not found，求解决方法

开发者阿泽

2026-7-6

解决Neovim中'lazy'模块找不到的错误

错误信息

Error detected while processing /Users/jmawirat/.config/nvim/init.lua:
E5113: Error while calling lua chunk: /Users/jmawirat/.config/nvim/lua/config/lazy.lua:9: module 'lazy' not found:
        no field package.preload['lazy']
        no file './lazy.lua'
        no file '/opt/homebrew/share/luajit-2.1/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 '/opt/homebrew/share/lua/5.1/lazy.lua'
        no file '/opt/homebrew/share/lua/5.1/lazy/init.lua'
        no file './lazy.so'
        no file '/usr/local/lib/lua/5.1/lazy.so'
        no file '/opt/homebrew/lib/lua/5.1/lazy.so'
        no file '/usr/local/lib/lua/5.1/loadall.so'
stack traceback:
        [C]: in function 'require'
        /Users/jmawirat/.config/nvim/lua/config/lazy.lua:9: in main chunk
        [C]: in function 'require'
        /Users/jmawirat/.config/nvim/init.lua:2: in main chunk
Press ENTER or type command to continue

已尝试的步骤

卸载并重新安装Neovim
删除整个~/.config/nvim目录

有效解决办法

手动安装lazy.nvim
执行命令将lazy.nvim克隆到Neovim配置的指定路径：
```
git clone https://github.com/folke/lazy.nvim.git ~/.config/nvim/lazy/lazy.nvim
```

修复init.lua中的lazy加载逻辑
确保init.lua包含自动检测并安装lazy的代码，示例：

local lazypath = vim.fn.stdpath("config") .. "/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)

require("lazy").setup("plugins")

添加后重启Neovim，会自动完成lazy的初始化。

检查并修复目录权限
确保当前用户对Neovim配置目录有读写权限：
```
chown -R $USER:$USER ~/.config/nvim
chmod -R 755 ~/.config/nvim
```
验证Neovim版本
lazy.nvim要求Neovim版本≥0.8.0，检查版本：
```
nvim --version
```
版本过低则升级，Homebrew用户执行：
```
brew upgrade neovim
```