Neovim会话插件设置调试方法及已加载包选项查看工具咨询

一、会话内调试插件设置的实用技巧 #

• 直接查看插件生效配置：通过Lua命令打印插件的当前配置表，比如针对telescope执行：

  :lua print(vim.inspect(require("telescope.config").values))
  

  替换telescope为你要调试的插件名，就能看到实际生效的参数，判断是否和你的配置一致。

• 确认插件加载状态：

  • 用Lazy.nvim自带的:Lazy命令打开插件管理界面，选中目标插件按K查看详情，能看到是否加载、加载触发条件、依赖关系；
  • 执行:lua print(vim.inspect(package.loaded["插件名"]))，如果返回nil说明插件未加载，检查你的配置里是否设置了正确的加载触发（比如ft、cmd等）。

• 动态测试配置修改：在命令行临时执行插件的setup函数，比如：

  :lua require("nvim-tree").setup({ view = { width = 40 } })
  

  立刻测试插件功能，确认配置生效后，再把修改同步到你的LazyVim配置文件中。

• 启用详细日志排查：启动Neovim时添加参数nvim -V3logfile.txt，生成的logfile.txt会记录插件加载顺序、配置应用的每一步，能帮你发现配置是否被后续插件覆盖，或者加载时机不对的问题。

• 检查自动命令与键映射：

  • 用:autocmd查看相关自动命令是否正确注册；
  • 用:nmap/:imap等查看键映射，或者执行:lua print(vim.inspect(vim.api.nvim_get_keymap("n")))打印普通模式所有键映射，搜索你设置的快捷键是否存在。

二、查看已加载包/插件的选项 #

• Lazy.nvim原生功能：

  • 执行:Lazy进入管理界面，按f输入loaded过滤已加载插件，选中插件按d查看详细配置，里面会列出该插件的所有选项及当前生效值；
  • 执行:Lazy debug可以查看插件加载的时序图，以及每个插件的加载详情，包括配置应用过程。

• 原生Lua命令：不需要额外插件，直接执行：

  :lua print(vim.inspect(package.loaded))
  

  会打印所有已加载的Lua模块，内容较多时可以加过滤：

  :lua for name, _ in pairs(package.loaded) do if name:match("nvim%-tree") then print(name) end end
  

  替换nvim%-tree为你要查找的插件关键词即可。

• 轻量辅助工具：folke/which-key.nvim虽然主打键映射管理，但能直观展示插件注册的所有快捷键，间接判断插件是否正确加载并应用配置；nvim-lua/plenary.nvim的调试模块也能辅助查看模块状态，但日常用原生和Lazy的功能足够。

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