Nvim :help pages, generated from source using the tree-sitter-vimdoc parser.


health.vim is a minimal framework to help users troubleshoot configuration and any other environment conditions that a plugin might care about. Nvim ships with healthchecks for configuration, performance, python support, ruby support, clipboard support, and more.
To run all healthchecks, use:
Plugin authors are encouraged to write new healthchecks. health-dev
:che :checkhealth :che[ckhealth] Run all healthchecks. E5009 Nvim depends on $VIMRUNTIME, 'runtimepath' and 'packpath' to find the standard "runtime files" for syntax highlighting, filetype-specific behavior, and standard plugins (including :checkhealth). If the runtime files cannot be found then those features will not work.
:che[ckhealth] {plugins} Run healthcheck(s) for one or more plugins. E.g. to run only the standard Nvim healthcheck:
To run the healthchecks for the "foo" and "bar" plugins (assuming they are on 'runtimepath' and they have implemented the Lua require("").check() interface):
:checkhealth foo bar
To run healthchecks for Lua submodules, use dot notation or "*" to refer to all submodules. For example Nvim provides vim.lsp and vim.treesitter:
:checkhealth vim.lsp vim.treesitter
:checkhealth vim*
Create a healthcheck health-dev
Healthchecks are functions that check the user environment, configuration, or any other prerequisites that a plugin cares about. Nvim ships with healthchecks in:
and more...
To add a new healthcheck for your own plugin, simply create a "health.lua" module on 'runtimepath' that returns a table with a "check()" function. Then :checkhealth will automatically find and invoke the function.
For example if your plugin is named "foo", define your healthcheck module at one of these locations (on 'runtimepath'):
If your plugin also provides a submodule named "bar" for which you want a separate healthcheck, define the healthcheck at one of these locations:
All such health modules must return a Lua table containing a check() function.
Copy this sample code into lua/foo/health.lua, replacing "foo" in the path with your plugin name:
local M = {}
M.check = function()"foo report")
  -- make sure setup function parameters are ok
  if check_setup() then"Setup is correct")
  else"Setup is incorrect")
  -- do some more checking
  -- ...
return M
error({msg}, {...}) Reports an error.
{msg} (string)
{...} (string|string[]) Optional advice
info({msg}) Reports an informational message.
{msg} (string)
ok({msg}) Reports a "success" message.
{msg} (string)
start({name}) Starts a new report. Most plugins should call this only once, but if you want different sections to appear in your report, call this once per section.
{name} (string)
warn({msg}, {...}) Reports a warning.
{msg} (string)
{...} (string|string[]) Optional advice
Commands index
Quick reference