// troubleshooting guide · neovim
Neovim: module 'nvim-treesitter.configs' not found
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 21, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · neovim/module-nvim-treesitter-configs-not-found2 FIXES
// quick answer
The nvim-treesitter default branch is now a full incompatible rewrite (main) that removed nvim-treesitter.configs. Either pin the frozen master branch (Neovim 0.11) or migrate to require('nvim-treesitter').install and vim.treesitter.start().
Most likely fix: Migrate to the main-branch API
How to fix it
// try these in order, the most common fix is first
FIX 1Migrate to the main-branch API
- 01Replace require('nvim-treesitter.configs').setup{...} with require('nvim-treesitter').install({ 'lua', 'python', 'rust' })
- 02Enable highlighting per filetype with an autocommand calling vim.treesitter.start()
- 03Install tree-sitter-cli (0.26.1+) with your package manager, not npm
- 04Run :checkhealth nvim-treesitter
Did this fix it?FIX 2Stay on the frozen master branch
- 01Pin branch = 'master' in your plugin spec (lazy.nvim: { 'nvim-treesitter/nvim-treesitter', branch = 'master' })
- 02Delete the plugin directory under stdpath('data') and restart so it re-clones the right branch
- 03Note master is locked and only meant for Neovim 0.11
Did this fix it?
SANDBOX · neovim RUNS IN YOUR BROWSER
Try it: edit code in a Neovim-style modal editor
A hands-on Neovim-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Error: module 'nvim-treesitter.configs' not found on startup, or highlighting disappears after :Lazy update.
Why it happens
- C-01Plugin updated to the rewritten main branch, which has no configs module
- C-02Old config still calls require('nvim-treesitter.configs').setup{}
- C-03Plugin manager kept the old master checkout or mixed branches
// this guide also covers
- module nvim-treesitter.configs not found
- nvim-treesitter main branch
- nvim-treesitter master vs main
Still not working?
If Neovim keeps failing, you're not alone. See every Neovim problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
Other Neovim errors
- Neovim LSP Not Working or Not Attaching
- require('lspconfig') Is Deprecated Warning in Neovim
- Neovim Treesitter Highlighting Not Working
- Neovim Clipboard Not Working (clipboard: No provider)
- Neovim Colors Wrong in tmux
- Neovim Escape Key Delay in tmux
- Mason Failed to Install Language Server in Neovim
- Why Is Neovim So Slow? (Startup Lag and Large Files)