如何用lazy.nvim配置mini-files的按键映射？

问题 #

离开Neovim几年后切换到lazy.nvim，已安装mini.nvim插件，尝试配置mini-files的按键映射但所有修改均未生效。plugins.lua加载自lazy.lua，相关代码如下：

{
    "echasnovski/mini.nvim",
    version = false,

    config = function()
      require("mini.files").setup({
        mappings = {
          close = "q",
          go_in = "x",
          go_in_plus = "<CR>",
          go_out = "h",
          go_out_plus = "H",
          reset = "<BS>",
          reveal_cwd = "@",
          show_help = "g?",
          synchronize = "=",
          trim_left = "<",
          trim_right = ">",
        },
      })
    end,
  },

  { "Pocco81/auto-save.nvim" },
}

已确认mini-files官方文档存在对应设置选项，但修改未被识别。需了解在lazy.nvim中配置插件的正确方法，同时注意到LazyVim有针对mini-files的额外插件支持。

解决方案 #

1. 确认lazy.nvim的配置加载路径 #

首先确保plugins.lua位于lazy.nvim默认加载路径（lua/plugins/目录），或者在lazy.lua中明确指定加载路径：

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

2. 正确配置mini-files的两种方案 #

方案一：直接在mini.nvim的config中配置

你的代码结构本身合规，可能是其他插件覆盖了映射，或配置未被正确加载。可先禁用其他插件测试，或在setup后手动补全缓冲区映射：

{
  "echasnovski/mini.nvim",
  version = false,
  config = function()
    local minifiles = require("mini.files")
    minifiles.setup({
      mappings = {
        close = "q",
        go_in = "x",
        go_in_plus = "<CR>",
        go_out = "h",
        go_out_plus = "H",
        reset = "<BS>",
        reveal_cwd = "@",
        show_help = "g?",
        synchronize = "=",
        trim_left = "<",
        trim_right = ">",
      },
    })
    -- 手动绑定缓冲区映射（防止setup未生效）
    vim.keymap.set("n", "<CR>", minifiles.go_in_plus, { buffer = true })
    vim.keymap.set("n", "h", minifiles.go_out, { buffer = true })
  end,
},

方案二：基于LazyVim的额外插件配置

如果使用LazyVim框架，官方的mini-files额外插件已包含基础配置，只需先启用该插件，再通过opts覆盖默认映射：

1. 在lazy.lua中导入额外插件：

{ import = "lazyvim.plugins.extras.editor.mini-files" },

2. 在自定义插件配置中覆盖映射：

{
  "echasnovski/mini.nvim",
  opts = {
    files = {
      mappings = {
        close = "q",
        go_in = "x",
        go_in_plus = "<CR>",
        go_out = "h",
        go_out_plus = "H",
        reset = "<BS>",
        reveal_cwd = "@",
        show_help = "g?",
        synchronize = "=",
        trim_left = "<",
        trim_right = ">",
      },
    },
  },
},

3. 验证配置有效性 #

执行:checkhealth mini.files查看插件健康状态，确认配置是否加载成功；也可在mini-files窗口中执行:map，检查当前缓冲区的按键映射是否符合预期。

内容的提问来源于stack exchange，提问作者Sean Clark Hess