Skip to main content
Version: 1.2

Overview

LunarVim strives to have support for all major languages. This is made possible by utilizing some of the great plugins in Neovim's ecosystem. Such plugins are nvim-lspconfig, for LSP support, and Null-ls to provide support for handling external formatters, such as prettier and eslint. Furthermore, LunarVim integrates with nvim-treesitter to provide rich syntax highlighting and other language parsing magic.

If your language is not supported please check the following links and file a ticket so we can

  • Check if LSP support is available in the lspconfig repo
  • Check if your linter or formatter is available in the null-ls repo
  • Check if your syntax is supported in the treesitter repo

At a glanceโ€‹

You can use the following commands to check some information about any language servers that you have configured.

  • :LvimInfo

    • Contains information about all the servers attached to the buffer you are editing and their current capabilities, such as formatting and go-to definition support. It also includes information related to any linters and formatters that are, or can be, configured.
    • keybind: <leader>Li
  • :LspInfo

    • Contains basic information about all the servers that are running.
    • keybind: <leader>li
  • :Mason

    • Contains information about all the servers that you can manage with mason.
    • keybind: <leader>lI

LSP supportโ€‹

Installing and updating a serverโ€‹

Automatic server installationโ€‹

By default, most supported language servers will get automatically installed once you open the supported file-type, e.g, opening a Python file for the first time will install Pyright and configure it automatically for you.

  • configuration option
lvim.lsp.automatic_servers_installation = true

Please refer to mason to see the updated full list of currently available servers.

To install a supported language server:

:LspInstall `<your_language_server>`

You can also toggle <:Mason> and interactively choose which servers to install.

Server overrideโ€‹

lvim.lsp.automatic_configuration.skipped_servers contains a list of servers that will not be automatically configured by default, for example only tsserver is allowed for JS-family languages, and when a language has more than one server available, then the most popular one is usually chosen.

tip

Overriding a server will completely bypass the lsp-installer, so you would have to manage the installation for any of those servers manually.

See the current list

:lua print(vim.inspect(lvim.lsp.automatic_configuration.skipped_servers))

See the default list in lua/lvim/lsp/config.lua

tip

Any changes to lvim.lsp.automatic_configuration.skipped_servers must be followed by :LvimCacheReset to take effect.

Server setupโ€‹

LunarVim uses filetype plugins to enable lazy-loading the setup of a language server. A template generator is used to create ftplugin files and populate them with the setup call.

  • configuration option
lvim.lsp.templates_dir = join_paths(get_runtime_dir(), "after", "ftplugin")

A typical setup call with default arguments

-- edit this file by running `:lua vim.cmd("edit " .. lvim.lsp.templates_dir .. "/lua.lua")`
require("lvim.lsp.manager").setup("sumneko_lua")
tip

You can quickly find these files by running <leader>Lf -> "Find LunarVim Files"

Overriding the default setup optionsโ€‹

Add the server you wish to configure manually to lvim.lsp.automatic_configuration.skipped_servers.

vim.list_extend(lvim.lsp.automatic_configuration.skipped_servers, { "pyright" })

Now you can set it up manually using the builtin lsp-manager

--- list of options that should take precedence over any of LunarVim's defaults
--- check the lspconfig documentation for a list of all possible options
local opts = {}
require("lvim.lsp.manager").setup("pyright", opts)

Alternatively, set it up using the lspconfig API directly

--- check the lspconfig documentation for a list of all possible options
local opts = {}
require("lspconfig")["pyright"].setup(opts)

Server settingsโ€‹

To set a setting for your language server:

:LspSettings <TAB>
:LspSettings <NAME_OF_LANGUAGE_SERVER>

This will create a file in $LUNARVIM_CONFIG_DIR/lsp-settings, to enable persistent changes. Refer to the documentation of nlsp-settings for a full updated list of supported language servers.

tip

Make sure to install jsonls for autocompletion.

Linting/Formattingโ€‹

Set a linter/formatter, this will override the language server formatting capabilities (if it exists)

local formatters = require "lvim.lsp.null-ls.formatters"
formatters.setup {
{ command = "black" },
{
command = "prettier",
args = { "--print-width", "100" },
filetypes = { "typescript", "typescriptreact" },
},
}

local linters = require "lvim.lsp.null-ls.linters"
linters.setup {
{ command = "flake8" },
{
command = "shellcheck",
args = { "--severity", "warning" },
},
{
command = "codespell",
filetypes = { "javascript", "python" },
},
}

local code_actions = require "lvim.lsp.null-ls.code_actions"
code_actions.setup {
{
command = "proselint"
},
}

Another method is to reference the linter/formatter/code_actions by their names, as referenced in null-ls docs, if you do not want to customize the command

local formatters = require "lvim.lsp.null-ls.formatters"
formatters.setup {
{ name = "black" },
}

local linters = require "lvim.lsp.null-ls.linters"
linters.setup {
{ name = "flake8" },
{ name = "shellcheck" },
{
name = "codespell",
filetypes = { "javascript", "python" },
},
}

local code_actions = require "lvim.lsp.null-ls.code_actions"
code_actions.setup {
{
name = "proselint"
},
}

This will lookup the provided name in the builtin configurations of null_ls and apply them. It can be considered equivalent to null_ls.builtins.diagnostics.{name}/null_ls.builtins.formatting.{name}/null_ls.builtins.code_actions.{name}

Note: Formatters' or Linters' or Code Actions installation is not managed by LunarVim. Refer to the each tool's respective manual for installation steps.

Custom argumentsโ€‹

It's also possible to add custom arguments for each linter/formatter/code_actions.

local formatters = require "lvim.lsp.null-ls.formatters"
formatters.setup {
{
command = "prettier",
---@usage arguments to pass to the formatter
-- these cannot contain whitespace, options such as `--line-width 80` become either `{'--line-width', '80'}` or `{'--line-width=80'}`
args = { "--print-width", "100" },
},
}

local linters = require "lvim.lsp.null-ls.linters"
linters.setup {
{
command = "shellcheck",
---@usage arguments to pass to the formatter
-- these cannot contain whitespace, options such as `--line-width 80` become either `{'--line-width', '80'}` or `{'--line-width=80'}`
args = { "--severity", "warning" },
},
}

local code_actions = require "lvim.lsp.null-ls.code_actions"
code_actions.setup {
{
command = "proselint",
args = { "--json" },
},
}

Note: remember that arguments cannot contains spaces, options such as --line-width 80 become either {'--line-width', '80'} or {'--line-width=80'}.

Multi languages per linter/formatterโ€‹

By default a formatter will attach to all the filetypes it supports.

local formatters = require "lvim.lsp.null-ls.formatters"
formatters.setup {
{
command = "prettier",
---@usage specify which filetypes to enable. By default a providers will attach to all the filetypes it supports.
filetypes = { "typescript", "typescriptreact" },
},
}

Note: removing the filetypes argument will allow the formatter to attach to all the default filetypes it supports.

Multi linters/formatters/code_actions per languageโ€‹

There are no restrictions on setting up multiple formatters per language

local formatters = require "lvim.lsp.null-ls.formatters"
formatters.setup {
{
{ command = "black", filetypes = { "python" } },
{ command = "isort", filetypes = { "python" } },
},
}

local linters = require "lvim.lsp.null-ls.linters"
linters.setup {
{
command = "codespell",
---@usage specify which filetypes to enable. By default a providers will attach to all the filetypes it supports.
filetypes = { "javascript", "python" },
},
}

local code_actions = require "lvim.lsp.null-ls.code_actions"
code_actions.setup {
{
command = "proselint",
args = { "--json" },
filetypes = { "markdown", "tex" },
},
}

Lazy-loading the linter/formatter/code_actions setupโ€‹

By default, all null-ls providers are checked on startup. If you want to avoid that or want to only set up the provider when you opening the associated file-type, then you can use filetype plugins for this purpose.

Let's take python as an example:

  1. create a file called python.lua in the $LUNARVIM_CONFIG_DIR/after/ftplugin folder
  2. add the following snippet
local linters = require "lvim.lsp.null-ls.linters"
linters.setup({{command = "flake8", filetypes = { "python" } }})

Formatting on saveโ€‹

You can disable auto-command and is to true by default.

  • configuration option
lvim.format_on_save = true