如何查看与修改Neovim Lua的runtimepath？模块加载问题求助

问题分析 #

你的目录结构符合Neovim Lua配置的标准规范，但require('basic')失败而require('lua.basic')能正常运行，说明Neovim的Lua模块搜索路径（package.path）未自动包含~/.config/nvim/lua目录——尽管~/.config/nvim已在runtimepath中。

查看runtimepath与Lua搜索路径 #

1. 查看Neovim的runtimepath #

• Vim命令方式：

  :echo &runtimepath
  

• Lua命令方式：

  :lua print(vim.inspect(vim.o.runtimepath))
  

2. 查看Lua的模块搜索路径 #

要确认Lua实际搜索模块的路径，执行：

:lua print(package.path)

正常情况下，Neovim会自动把runtimepath下的lua/?.lua和lua/?/init.lua加入package.path，如果输出里没有~/.config/nvim/lua/?.lua，就是问题所在。

修改runtimepath与Lua搜索路径 #

1. 添加目录到runtimepath #

在init.vim中添加以下配置，将lua目录加入runtimepath：

set runtimepath+=~/.config/nvim/lua

2. 直接修改Lua的package.path #

如果上述方法无效，可手动在init.vim中通过Lua代码扩展搜索路径：

lua << EOF
package.path = package.path .. ';' .. vim.fn.stdpath('config') .. '/lua/?.lua'
EOF

修改后，Lua会直接搜索~/.config/nvim/lua下的模块，此时require('basic')即可正常加载。

解决当前加载失败的方案 #

优先检查Neovim版本，较旧版本可能存在自动添加lua目录到搜索路径的bug，建议升级到稳定版。如果暂时无法升级，直接使用上述修改package.path的方法即可解决问题。另外确保~/.config/nvim/lua目录和basic.lua文件拥有可读权限。

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