Neovim Debugging with nvim-dap: Breakpoints and Live Inspection

Debugging in the Terminal

Set breakpoints, step through code, and inspect variables directly in Neovim using nvim-dap and a language debugger for a full IDE experience.

Neovim's Lua API means your editor config is a real program — not a pile of Vimscript variables. You get functions, loops, conditionals, and lazy loading for free.

By the end of this 12 min guide, you'll have a working Neovim setup and practical nvim-dap workflows you can use immediately.

• Understand what Neovim does and why it matters for Development
• Install and configure Neovim for your environment
• Build nvim-dap-specific workflows with real examples
• Troubleshoot common Neovim issues with concrete fixes

Installing nvim-dap & Adapters

Install Neovim:

brew install neovim ripgrep

• Development environment with appropriate permissions
• No prior nvim-dap experience needed
• A terminal with true color support
• Git for version-controlling your config

DAP Configuration Basics

Structure your config into modular files under lua/. Each file handles one concern: options, keymaps, plugins, autocmds.

Here's a foundational configuration to start with:

-- keymaps.lua
vim.keymap.set("n", "w", ":w", { desc = "Save" })
vim.keymap.set("n", "q", ":q", { desc = "Quit" })
vim.keymap.set("n", "e", ":NvimTreeToggle", { desc = "Toggle file tree" })

• Begin with this config and make small, incremental changes
• Document each setting with inline comments
• Test changes one at a time to isolate issues
• Keep your config in a Git repo for easy rollback and sharing

Breakpoints & Stepping

With Neovim configured, these nvim-dap-specific workflows will save you time every day:

• <leader>ff find files with Telescope
• <leader>fg live grep across project
• gd go to definition via LSP
• gr list references
• <C-h/j/k/l> navigate window splits

REPL, Watches & Scopes

Once you're comfortable with Neovim basics, these advanced techniques will transform your nvim-dap workflow:

• Lazy-load plugins on specific events or keys for instant startup
• Use autocmd to run code on file type changes
• Integrate LSP for go-to-definition and hover docs
• Add Treesitter for AST-based syntax highlighting

Adapter & Session Issues

Here are the most common Neovim issues and how to fix them:

• LSP not attaching? Run :LspInfo to check active clients
• Treesitter errors? Run :TSUpdate to update parsers
• Plugin missing? Run :Lazy sync to install all
• Slow startup? Run :Lazy profile to find the bottleneck

Debug Mastery

Congratulations — you now have a solid Neovim foundation. Here's where to go next:

• Explore the official Neovim documentation for features not covered here
• Join the nvim-dap community (GitHub Discussions, Discord, or Reddit)
• Check the related tutorials below for deeper nvim-dap dives
• Build your own Neovim configuration and share it with the community