// troubleshooting guide · neovim

How to Fix Neovim :checkhealth Warnings and Errors

Status
Workaround available
platforms:
Windows, macOS, Linux
updated:
November 21, 2026
reports:
3
Method
how we research
Share

RUNBOOK · neovim/checkhealth-warnings3 FIXES

// quick answer

Run :checkhealth, read the WARNING and ERROR lines per module, and fix the missing provider, executable or deprecated API they name. You can scope it, for example :checkhealth vim.lsp vim.treesitter.

Most likely fix: Scope the check

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Scope the check

    1. 01Run :checkhealth vim.lsp vim.treesitter or :checkhealth <plugin>
    2. 02Ignore warnings for providers you do not use (ruby, perl)
    Did this fix it?
  2. FIX 2Fix deprecation warnings

    1. 01Run :checkhealth vim.deprecated to see the offending calls
    2. 02Update the plugin or replace the call in your config
    3. 03Check :messages for the file that triggers it
    Did this fix it?
  3. FIX 3Install missing executables

    1. 01Install ripgrep, fd, a C compiler and tree-sitter-cli where the plugin asks
    2. 02Rebuild plugins with build steps (for example blink.cmp fuzzy library)
    3. 03Restart Neovim
    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

:checkhealth shows WARNING/ERROR lines about providers, deprecated functions, missing executables or plugins.

Why it happens

  • C-01Optional providers (python, node, ruby, perl) not installed
  • C-02Config or plugin calls an obsolete API such as vim.fn.sign_define
  • C-03Plugin needs an external binary (ripgrep, fd, tree-sitter-cli, a compiled library)
  • C-04Outdated Neovim for the plugin version

// this guide also covers

  • neovim checkhealth warnings
  • nvim checkhealth error
  • checkhealth vim.deprecated

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 us

Watch Neovim Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Neovim errors

All 16 Neovim errors and fixes →