Lua模块引入失败求助：无法找到snippets.math-util

问题描述 #

在Windows PowerShell环境下使用Neovim时，尝试在markdown.lua文件中通过local is_math_mode = require('snippets.math-util')语句导入同目录下的math-util.lua模块，触发"模块未找到"错误。

文件结构 #

nvim/snippets/markdown.lua
nvim/snippets/math-util.lua

已尝试的解决动作 #

• 手动更新Lua模块搜索路径：

  package.path = package.path .. ';' .. 'C:/Users/joene/AppData/Local/nvim/snippets/?.lua'
  

• 在snippets目录下创建了init.lua文件

错误日志 #

Error detected while processing :source (no file):                                                                                                            
E5108: Error executing lua [string ":source (no file)"]:8: module 'snippets.math-util' not found:                                                                      
no field package.preload['snippets.math-util']                                                                                                        
cache_loader: module snippets.math-util not found                                                                                                             
cache_loader_lib: module snippets.math-util not found                                                                                                                
no file '.\snippets\math-util.lua'                                                                                                                            
no file 'C:\tools\neovim\nvim-win64\bin\lua\snippets\math-util.lua'                                                                                           
no file 'C:\tools\neovim\nvim-win64\bin\lua\snippets\math-util\init.lua'                                                                                      
no file 'C:\Program Files (x86)\Lua\5.1\lua\snippets\math-util.luac'                                                                                        
no file 'C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/nvim-dap-python/share/lua/5.1/snippets\math-util.lua'                                              
no file 'C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/nvim-dap-python/share/lua/5.1/snippets\math-util/init.lua'                                         
no file 'C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/telescope.nvim/share/lua/5.1/snippets\math-util.lua'                                               
no file 'C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/telescope.nvim/share/lua/5.1/snippets\math-util/init.lua'                                          
no file 'C:/Users/joene/AppData/Local/nvim/snippets/snippets\math-util.lua'                                                                                                                                                                                                                                                          
no file '.\snippets\math-util.lua'                                                                                                                            
no file 'C:\tools\neovim\nvim-win64\bin\lua\snippets\math-util.lua'                                                                                           
no file 'C:\tools\neovim\nvim-win64\bin\lua\snippets\math-util\init.lua'                                                                                      
no file 'C:\Program Files (x86)\Lua\5.1\lua\snippets\math-util.luac'                                                                                        
no file 'C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/nvim-dap-python/share/lua/5.1/snippets\math-util.lua'                                              
no file 'C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/nvim-dap-python/share/lua/5.1/snippets\math-util/init.lua'                                         
no file 'C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/telescope.nvim/share/lua/5.1/snippets\math-util.lua'                                               
no file 'C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/telescope.nvim/share/lua/5.1/snippets\math-util/init.lua'                                          
no file 'C:/Users/joene/AppData/Local/nvim/snippets/snippets\math-util.lua'                                                                                                                                                                      
no file 'C:/Users/joene/AppData/Local/nvim/sni

当前package.path #

;\?.lua;C:\tools\neovim\nvim-win64\bin\lua\?.lua;C:\tools\neovim\nvim-win64\bin\lua\?\init.lua;;C:\Program Files (x86)\Lua\5.1\lua\?.luac;C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/nvim-dap-python/share/lua/5.1/?.lua;C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/nvim-dap-python/share/lua/5.1/?/init.lua;;C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/telescope.nvim/share/lua/5.1/?.lua;C:\Users\joene\AppData\Local\nvim-data/lazy-rocks/telescope.nvim/share/lua/5.1/?/init.lua;;C:/Users/joene/AppData/Local/nvim/snippets/?.lua

可行解决思路 #

• 修正require路径：两个文件处于同一目录，直接使用相对路径或简化模块名导入：

  -- 方式1：直接导入同目录模块
  local is_math_mode = require('math-util')
  -- 方式2：使用当前文件目录定位（更可靠）
  local current_dir = vim.fn.expand('%:p:h')
  package.path = package.path .. ';' .. current_dir .. '/?.lua'
  local is_math_mode = require('math-util')
  

• 修复package.path格式问题：当前路径开头存在无效的;\?.lua，建议用Neovim标准方式添加配置目录路径，避免手动拼接出错：

  local snippets_dir = vim.fn.stdpath('config') .. '/snippets'
  package.path = table.concat({
    package.path,
    snippets_dir .. '/?.lua',
    snippets_dir .. '/?/init.lua'
  }, ';')
  

• 检查路径拼接错误：从错误日志可见，Lua尝试查找C:/Users/joene/AppData/Local/nvim/snippets/snippets\math-util.lua，说明路径重复嵌套，需确保添加的路径是C:/Users/joene/AppData/Local/nvim/snippets/?.lua而非包含多余snippets的路径。
• 验证路径有效性：在Neovim中执行:lua print(vim.inspect(package.path))，确认snippets目录已正确加入搜索路径，且格式无错误。

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