Neovim plugin to auto install LSP servers
Neovim plugin to automatically install nvim-lspconfig language servers. It is an alternative to mason.nvim.
To ease the setup even further it can be complemented with lsp-zero.nvim.
Language servers are loaded in the background without a need of a manual user intervention. They are not installed upfront, but only on-demand after a source file for a given language is opened. The plugin works by relying on Nix package manager which works on Linux, macOS and Windows WSL.
Currently available 116 out of 301 servers in lspconfig, see the full list of supported servers.
Requires Neovim v0.7.0+
curl -L https://nixos.org/nix/install | sh
{
"dundalek/lazy-lsp.nvim",
dependencies = { "neovim/nvim-lspconfig" },
config = function()
require("lazy-lsp").setup {}
end
},
Alternatively, you can install the plugin via Nix/Home Manager.
Quickest way to configure is to use lsp-zero.nvim which sets up key bindings and autocompletion.
{
"dundalek/lazy-lsp.nvim",
dependencies = {
"neovim/nvim-lspconfig",
{"VonHeikemen/lsp-zero.nvim", branch = "v3.x"},
"hrsh7th/cmp-nvim-lsp",
"hrsh7th/nvim-cmp",
},
config = function()
local lsp_zero = require("lsp-zero")
lsp_zero.on_attach(function(client, bufnr)
-- see :help lsp-zero-keybindings to learn the available actions
lsp_zero.default_keymaps({
buffer = bufnr,
preserve_mappings = false
})
end)
require("lazy-lsp").setup {}
end,
},
Another approach is to configure manually by passing on_attach
handler which sets up keybindings and capabilities
for autocompletion in the default_config
section.
Available configuration options:
require("lazy-lsp").setup {
-- By default all available servers are set up. Exclude unwanted or misbehaving servers.
excluded_servers = {
"ccls", "zk",
},
-- Alternatively specify preferred servers for a filetype (others will be ignored).
preferred_servers = {
markdown = {},
python = { "pyright", "ruff_lsp" },
},
prefer_local = true, -- Prefer locally installed servers over nix-shell
-- Default config passed to all servers to specify on_attach callback and other options.
default_config = {
flags = {
debounce_text_changes = 150,
},
-- on_attach = on_attach,
-- capabilities = capabilities,
},
-- Override config for specific servers that will passed down to lspconfig setup.
-- Note that the default_config will be merged with this specific configuration so you don't need to specify everything twice.
configs = {
lua_ls = {
settings = {
Lua = {
diagnostics = {
-- Get the language server to recognize the `vim` global
globals = { "vim" },
},
},
},
},
},
}
The philosophy of this plugin is to enable all possible plugins by default to get the highest chance of LSP functionality being available, even at a cost of starting multiple servers for a single language. Any misbehaving or unwanted servers can be excluded one by one.
If this is not what you want, you can give a try to the curated configuration that enables smaller selection of recommended servers.
lazy-lsp
registers all available configurations from lspconfig to start LSP servers by wrapping the commands in a nix-shell environment. The nix-shell prepares the environment by pulling all specified dependencies regardless of what is installed on the host system and avoids packages clashes. The first time a server is run there is a delay until dependencies are downloaded, but on subsequent runs the time to prepare the shell environment is negligible.
Nix uses channels to determine which packages and versions are available.
I recommend using the unstable
channel to get the latest versions.
If you encounter an older version of a language server try to run nix-channel --update
to update channels.
See docs about channels for more details how to work with channels.
:LspInstall
command needs to be run manually for each serverThe available lsp servers and stats are generated from nvim-lspconfig
source.
Make a local copy:
mkdir tmp && cd tmp
git clone https://github.com/neovim/nvim-lspconfig.git
Run nix-shell
to load dependencies needed for running the dev scripts.
Update servers.lua
with new entries:
cd tmp/nvim-lspconfig
git pull
cd ../..
scripts/update.lua
Once done specifying servers, generate the stats in servers.md:
scripts/genstats.lua
Using Plenary for testing, see the Testing Guide for details.
Run tests:
scripts/test
Run tests in watch mode:
scripts/test-watch