如何用Lua调试器挂载并调试NVim运行中的插件及触发断点？

核心逻辑 #

Neovim插件与自身Lua代码运行在同一Lua虚拟机中，你现有的普通Lua调试工具（如nvim-dap+nlua.nvim）完全适用，核心是调整调试目标的加载与附加方式，而非更换工具。

具体实现步骤与技巧 #

1. 切换调试器的附加模式

• 放弃直接用dap.run()运行脚本的方式，改用dap.attach()附加到当前Neovim进程的Lua VM。
• 配置nlua.nvim时，指定host = '127.0.0.1'与自定义端口（如8086），然后在init.lua最开头初始化调试服务器：

  require('nlua.lua_debugger').start('127.0.0.1', 8086)
  

• 启动Neovim后，通过nvim-dap的attach命令连接到本地端口，完成调试会话绑定。

2. 给快捷键触发的函数手动插断点

• 直接在你的插件函数（或init.lua中绑定的快捷键处理函数）里插入断点语句，无需依赖编辑器的断点标记：

  local function my_keybind_func()
    -- 手动插入断点，触发时自动暂停
    require('nlua.lua_debugger').breakpoint()
    -- 原函数逻辑
    local node = require('nvim-treesitter.ts_utils').get_node_at_cursor()
    vim.notify('当前节点类型：' .. node:type())
  end
  
  vim.keymap.set('n', '<leader>t', my_keybind_func, { desc = '触发treesitter逻辑' })
  

• 确保调试器初始化代码在插件加载前执行（比如用packer/lazy.nvim时，将调试器配置设为lazy=false），避免断点语句报错。

3. 调试Neovim自身Lua代码的简化方案

• 若仅需调试你对Neovim API的调用逻辑，直接在自己的代码中插入断点，跟踪参数与返回值即可，无需编译带调试符号的Neovim。
• 若要深入Neovim内部Lua实现（如vim.api的底层逻辑），需编译带调试符号的Neovim版本，结合GDB/lldb附加进程，但这属于进阶需求，插件开发很少用到。

4. 常见问题排查

• 断点不触发：检查调试器是否在插件加载前启动，比如lazy.nvim中可将调试器配置放在opts.init中，确保优先初始化。
• 调试会话无响应：更换调试端口，避免端口被其他进程占用；或者重启Neovim后重新附加调试器。
• 无法查看C绑定对象：Neovim中的vim.api等对象是C-Lua绑定，调试器无法直接解析内部结构，可配合vim.inspect()在断点处打印对象内容。

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