如何用单文件定义本地lazy.nvim插件？解决多文件加载冲突

问题核心 #

多个本地配置插件共享dir = '.'时，lazy.nvim会将它们识别为同一个插件，最终仅加载其中一个，导致静默冲突。

可行解决方案 #

1. 给每个配置文件设置唯一dir路径 #

让每个配置插件的dir指向自身所在的独立目录，避免路径重复。可以用Neovim内置函数自动获取当前文件的目录：

local function func ()
--------------------------------------------------------------------------------
--- Regular nvim lua config
--------------------------------------------------------------------------------
end

return {
    name = "config.configtype",
    dir = vim.fn.expand('%:p:h'), -- 自动获取当前文件所在的绝对目录
    dev = true,
    lazy = false,
    priority = 999,
    config = func
}

每个配置文件的dir会自动对应自身所在路径，确保唯一性，不会再被判定为同一插件。

2. 合并为单个本地插件拆分配置逻辑 #

放弃多插件形式，只定义一个本地插件，在其config函数中导入所有配置模块：

local function func()
  -- 按顺序导入各个配置模块
  require('config.core')
  require('config.keymaps')
  require('config.ui')
  require('config.lsp')
end

return {
  name = "user.config",
  dir = '.',
  dev = true,
  lazy = false,
  priority = 999,
  config = func
}

这种方式既保留了修改配置时lazy.nvim自动重载的特性，又避免了多插件路径冲突的问题，结构更简洁。

3. 补充唯一module标识（配合独立dir使用） #

如果坚持使用多插件形式，除了设置唯一dir，还可以添加module字段强化插件唯一性：

return {
    name = "config.configtype",
    dir = vim.fn.expand('%:p:h'),
    dev = true,
    lazy = false,
    priority = 999,
    module = "config.configtype", -- 与name对应，作为插件唯一标识
    config = func
}

冲突原因说明 #

lazy.nvim通过name和dir的组合识别插件唯一性，多个插件共享同一dir时，会被判定为同一插件的重复定义，最终仅加载优先级最高或最后加载的那个，导致其他配置无法执行。

内容的提问来源于stack exchange，提问作者Carlos González