201 KiB
Configurations
The following LSP configs are included. This documentation is autogenerated from the lua files. Follow a link to find documentation for
that config. This file is accessible in neovim via :help lspconfig-server-configurations
- als
- angularls
- ansiblels
- arduino_language_server
- bashls
- beancount
- bicep
- bsl_ls
- ccls
- clangd
- clojure_lsp
- cmake
- codeqlls
- crystalline
- csharp_ls
- cssls
- cucumber_language_server
- dartls
- denols
- dhall_lsp_server
- diagnosticls
- dockerls
- dotls
- efm
- elixirls
- elmls
- ember
- emmet_ls
- erlangls
- esbonio
- eslint
- flow
- flux-lsp
- fortls
- fsautocomplete
- fstar
- gdscript
- ghcide
- golangci_lint_ls
- gopls
- graphql
- groovyls
- haxe_language_server
- hie
- hls
- html
- idris2_lsp
- intelephense
- java_language_server
- jdtls
- jedi_language_server
- jsonls
- jsonnet_ls
- julials
- kotlin_language_server
- lean3ls
- leanls
- lelwel_ls
- lemminx
- ltex
- metals
- mint
- nickel_ls
- nimls
- ocamlls
- ocamllsp
- omnisharp
- pasls
- perlls
- perlpls
- phpactor
- powershell_es
- prismals
- psalm
- puppet
- purescriptls
- pylsp
- pyre
- pyright
- r_language_server
- racket_langserver
- rescriptls
- rls
- rnix
- robotframework_ls
- rome
- rust_analyzer
- scry
- serve_d
- sixtyfps
- solang
- solargraph
- sorbet
- sourcekit
- spectral
- sqlls
- sqls
- stylelint_lsp
- sumneko_lua
- svelte
- svls
- tailwindcss
- taplo
- terraform_lsp
- terraformls
- texlab
- tflint
- theme_check
- tsserver
- typeprof
- vala_ls
- vdmj
- vimls
- vls
- volar
- vuels
- yamlls
- zeta_note
- zk
- zls
als
https://github.com/AdaCore/ada_language_server
Installation instructions can be found here.
Can be configured by passing a "settings" object to als.setup{}:
require('lspconfig').als.setup{
settings = {
ada = {
projectFile = "project.gpr";
scenarioVariables = { ... };
}
}
}
Snippet to enable the language server:
require'lspconfig'.als.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ada_language_server" }
filetypes = { "ada" }
root_dir = util.root_pattern("Makefile", ".git", "*.gpr", "*.adc")
angularls
https://github.com/angular/vscode-ng-language-service
angular-language-server can be installed via npm npm install -g @angular/language-server.
Note, that if you override the default cmd, you must also update on_new_config to set new_config.cmd during startup.
local project_library_path = "/path/to/project/lib"
local cmd = {"ngserver", "--stdio", "--tsProbeLocations", project_library_path , "--ngProbeLocations", project_library_path}
require'lspconfig'.angularls.setup{
cmd = cmd,
on_new_config = function(new_config,new_root_dir)
new_config.cmd = cmd
end,
}
Snippet to enable the language server:
require'lspconfig'.angularls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ngserver", "--stdio", "--tsProbeLocations", "", "--ngProbeLocations", "" }
filetypes = { "typescript", "html", "typescriptreact", "typescript.tsx" }
root_dir = root_pattern("angular.json", ".git")
ansiblels
https://github.com/ansible/ansible-language-server
Language server for the ansible configuration management tool.
ansible-language-server can be installed via yarn:
yarn global add ansible-language-server
Snippet to enable the language server:
require'lspconfig'.ansiblels.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ansible-language-server", "--stdio" }
filetypes = { "yaml", "yaml.ansible" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {
ansible = {
ansible = {
path = "ansible"
},
ansibleLint = {
enabled = true,
path = "ansible-lint"
},
executionEnvironment = {
enabled = false
},
python = {
interpreterPath = "python"
}
}
}
single_file_support = true
arduino_language_server
https://github.com/arduino/arduino-language-server
Language server for Arduino
The arduino-language-server can be installed by running:
go get -u github.com/arduino/arduino-language-server
The arduino-cli tools must also be installed. Follow these instructions for your distro:
https://arduino.github.io/arduino-cli/latest/installation/
After installing the arduino-cli tools, follow these instructions for generating
a configuration file:
https://arduino.github.io/arduino-cli/latest/getting-started/#create-a-configuration-file
and make sure you install any relevant platforms libraries:
https://arduino.github.io/arduino-cli/latest/getting-started/#install-the-core-for-your-board
The language server also requires clangd be installed. It will look for clangd by default but
the binary path can be overridden if need be.
After all dependencies are installed you'll need to override the lspconfig command for the language server in your setup function with the necessary configurations:
lspconfig.arduino_language_server.setup({
cmd = {
-- Required
"arduino-language-server",
"-cli-config", "/path/to/arduino-cli.yaml",
-- Optional
"-cli", "/path/to/arduino-cli",
"-clangd", "/path/to/clangd"
}
})
For further instruction about configuration options, run arduino-language-server --help.
Snippet to enable the language server:
require'lspconfig'.arduino_language_server.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "arduino-language-server" }
filetypes = { "arduino" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
bashls
https://github.com/mads-hartmann/bash-language-server
Language server for bash, written using tree sitter in typescript.
Snippet to enable the language server:
require'lspconfig'.bashls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "bash-language-server", "start" }
cmd_env = {
GLOB_PATTERN = "*@(.sh|.inc|.bash|.command)"
}
filetypes = { "sh" }
root_dir = util.find_git_ancestor
single_file_support = true
beancount
https://github.com/polarmutex/beancount-language-server#installation
See https://github.com/polarmutex/beancount-language-server#configuration for configuration options
Snippet to enable the language server:
require'lspconfig'.beancount.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "beancount-langserver" }
filetypes = { "beancount" }
init_options = {
journalFile = "",
pythonPath = "python3"
}
root_dir = root_pattern("elm.json")
single_file_support = true
bicep
https://github.com/azure/bicep Bicep language server
Bicep language server can be installed by downloading and extracting a release of bicep-langserver.zip from Bicep GitHub releases.
Bicep language server requires the dotnet-sdk to be installed.
Neovim does not have built-in support for the bicep filetype which is required for lspconfig to automatically launch the language server.
Filetype detection can be added via an autocmd:
vim.cmd [[ autocmd BufNewFile,BufRead *.bicep set filetype=bicep ]]
By default, bicep language server does not have a cmd set. This is because nvim-lspconfig does not make assumptions about your path. You must add the following to your init.vim or init.lua to set cmd to the absolute path ($HOME and ~ are not expanded) of the unzipped run script or binary.
local bicep_lsp_bin = "/path/to/bicep-langserver/Bicep.LangServer.dll"
require'lspconfig'.bicep.setup{
cmd = { "dotnet", bicep_lsp_bin };
...
}
To download the latest release and place in /usr/local/bin/bicep-langserver:
(cd $(mktemp -d) \
&& curl -fLO https://github.com/Azure/bicep/releases/latest/download/bicep-langserver.zip \
&& rm -rf /usr/local/bin/bicep-langserver \
&& unzip -d /usr/local/bin/bicep-langserver bicep-langserver.zip)
Snippet to enable the language server:
require'lspconfig'.bicep.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "bicep" }
init_options = {}
root_dir = util.find_git_ancestor
bsl_ls
https://github.com/1c-syntax/bsl-language-server
Language Server Protocol implementation for 1C (BSL) - 1C:Enterprise 8 and OneScript languages.
Snippet to enable the language server:
require'lspconfig'.bsl_ls.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "bsl", "os" }
root_dir = root_pattern(".git")
ccls
https://github.com/MaskRay/ccls/wiki
ccls relies on a JSON compilation database specified as compile_commands.json or, for simpler projects, a compile_flags.txt. For details on how to automatically generate one using CMake look here. Alternatively, you can use Bear.
Customization options are passed to ccls at initialization time via init_options, a list of available options can be found here. For example:
local lspconfig = require'lspconfig'
lspconfig.ccls.setup {
init_options = {
compilationDatabaseDirectory = "build";
index = {
threads = 0;
};
clang = {
excludeArgs = { "-frounding-math"} ;
};
}
}
Snippet to enable the language server:
require'lspconfig'.ccls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ccls" }
filetypes = { "c", "cpp", "objc", "objcpp" }
root_dir = root_pattern("compile_commands.json", ".ccls", "compile_flags.txt", ".git") or dirname
single_file_support = false
clangd
https://clangd.llvm.org/installation.html
NOTE: Clang >= 9 is recommended! See this issue for more.
clangd relies on a JSON compilation database specified as compile_commands.json or, for simpler projects, a compile_flags.txt. For details on how to automatically generate one using CMake look here. Alternatively, you can use Bear.
Snippet to enable the language server:
require'lspconfig'.clangd.setup{}
Commands and default values:
Commands:
- ClangdSwitchSourceHeader: Switch between source/header
Default Values:
capabilities = default capabilities, with offsetEncoding utf-8
cmd = { "clangd", "--background-index" }
filetypes = { "c", "cpp", "objc", "objcpp" }
root_dir = root_pattern("compile_commands.json", "compile_flags.txt", ".git") or dirname
single_file_support = true
clojure_lsp
https://github.com/snoe/clojure-lsp
Clojure Language Server
Snippet to enable the language server:
require'lspconfig'.clojure_lsp.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "clojure-lsp" }
filetypes = { "clojure", "edn" }
root_dir = root_pattern("project.clj", "deps.edn", "build.boot", "shadow-cljs.edn", ".git")
cmake
https://github.com/regen100/cmake-language-server
CMake LSP Implementation
Snippet to enable the language server:
require'lspconfig'.cmake.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "cmake-language-server" }
filetypes = { "cmake" }
init_options = {
buildDirectory = "build"
}
root_dir = root_pattern(".git", "compile_commands.json", "build") or dirname
single_file_support = true
codeqlls
Reference: https://help.semmle.com/codeql/codeql-cli.html
Binaries: https://github.com/github/codeql-cli-binaries
Snippet to enable the language server:
require'lspconfig'.codeqlls.setup{}
Commands and default values:
Commands:
Default Values:
before_init = function(initialize_params)
initialize_params['workspaceFolders'] = {
{
name = 'workspace',
uri = initialize_params['rootUri'],
},
}
end,
cmd = { "codeql", "execute", "language-server", "--check-errors", "ON_CHANGE", "-q" }
filetypes = { "ql" }
log_level = 2
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {
search_path = "list containing all search paths, eg: '~/codeql-home/codeql-repo'"
}
single_file_support = true
crystalline
https://github.com/elbywan/crystalline
Crystal language server.
Snippet to enable the language server:
require'lspconfig'.crystalline.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "crystalline" }
filetypes = { "crystal" }
root_dir = root_pattern('shard.yml', '.git') or dirname
single_file_support = true
csharp_ls
https://github.com/razzmatazz/csharp-language-server
Language Server for C#.
csharp-ls requires the dotnet-sdk to be installed.
The preferred way to install csharp-ls is with dotnet tool install --global csharp-ls.
Snippet to enable the language server:
require'lspconfig'.csharp_ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "csharp-ls" }
filetypes = { "cs" }
init_options = {
AutomaticWorkspaceInit = true
}
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
cssls
https://github.com/hrsh7th/vscode-langservers-extracted
css-languageserver can be installed via npm:
npm i -g vscode-langservers-extracted
Neovim does not currently include built-in snippets. vscode-css-language-server only provides completions when snippet support is enabled. To enable completion, install a snippet plugin and add the following override to your language client capabilities during setup.
--Enable (broadcasting) snippet capability for completion
local capabilities = vim.lsp.protocol.make_client_capabilities()
capabilities.textDocument.completion.completionItem.snippetSupport = true
require'lspconfig'.cssls.setup {
capabilities = capabilities,
}
Snippet to enable the language server:
require'lspconfig'.cssls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "vscode-css-language-server", "--stdio" }
filetypes = { "css", "scss", "less" }
root_dir = root_pattern("package.json", ".git") or bufdir
settings = {
css = {
validate = true
},
less = {
validate = true
},
scss = {
validate = true
}
}
single_file_support = true
cucumber_language_server
https://cucumber.io https://github.com/cucumber/common https://www.npmjs.com/package/@cucumber/language-server
Language server for Cucumber.
cucumber-language-server can be installed via npm:
npm install -g @cucumber/language-server
Snippet to enable the language server:
require'lspconfig'.cucumber_language_server.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "cucumber-language-server", "--stdio" }
filetypes = { "cucumber" }
root_dir = util.find_git_ancestor
dartls
https://github.com/dart-lang/sdk/tree/master/pkg/analysis_server/tool/lsp_spec
Language server for dart.
Snippet to enable the language server:
require'lspconfig'.dartls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "dart", "./snapshots/analysis_server.dart.snapshot", "--lsp" }
filetypes = { "dart" }
init_options = {
closingLabels = true,
flutterOutline = true,
onlyAnalyzeProjectsWithOpenFiles = true,
outline = true,
suggestFromUnimportedLibraries = true
}
root_dir = root_pattern("pubspec.yaml")
settings = {
dart = {
completeFunctionCalls = true,
showTodos = true
}
}
denols
https://github.com/denoland/deno
Deno's built-in language server
To approrpiately highlight codefences returned from denols, you will need to augment vim.g.markdown_fenced languages in your init.lua. Example:
vim.g.markdown_fenced_languages = {
"ts=typescript"
}
Snippet to enable the language server:
require'lspconfig'.denols.setup{}
Commands and default values:
Commands:
- DenolsCache: Cache a module and all of its dependencies.
- DenolsDefinition: Jump to definition. This handle deno:/ schema in deno:// buffer.
- DenolsReferences: List references. This handle deno:/ schema in deno:// buffer.
Default Values:
cmd = { "deno", "lsp" }
filetypes = { "javascript", "javascriptreact", "javascript.jsx", "typescript", "typescriptreact", "typescript.tsx" }
handlers = {
["textDocument/definition"] = <function 1>,
["textDocument/references"] = <function 2>
}
init_options = {
enable = true,
lint = false,
unstable = false
}
root_dir = root_pattern("deno.json", "deno.jsonc", "tsconfig.json", ".git")
dhall_lsp_server
https://github.com/dhall-lang/dhall-haskell/tree/master/dhall-lsp-server
language server for dhall
dhall-lsp-server can be installed via cabal:
cabal install dhall-lsp-server
prebuilt binaries can be found here.
Snippet to enable the language server:
require'lspconfig'.dhall_lsp_server.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "dhall-lsp-server" }
filetypes = { "dhall" }
root_dir = root_pattern(".git") or dirname
single_file_support = true
diagnosticls
https://github.com/iamcco/diagnostic-languageserver
Diagnostic language server integrate with linters.
Snippet to enable the language server:
require'lspconfig'.diagnosticls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "diagnostic-languageserver", "--stdio" }
filetypes = Empty by default, override to add filetypes
root_dir = Vim's starting directory
single_file_support = true
dockerls
https://github.com/rcjsuen/dockerfile-language-server-nodejs
docker-langserver can be installed via npm:
npm install -g dockerfile-language-server-nodejs
Snippet to enable the language server:
require'lspconfig'.dockerls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "docker-langserver", "--stdio" }
filetypes = { "dockerfile" }
root_dir = root_pattern("Dockerfile")
single_file_support = true
dotls
https://github.com/nikeee/dot-language-server
dot-language-server can be installed via npm:
npm install -g dot-language-server
Snippet to enable the language server:
require'lspconfig'.dotls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "dot-language-server", "--stdio" }
filetypes = { "dot" }
root_dir = function(path)
-- Support git directories and git files (worktrees)
if M.path.is_dir(M.path.join(path, '.git')) or M.path.is_file(M.path.join(path, '.git')) then
return path
end
end)
end
single_file_support = true
efm
https://github.com/mattn/efm-langserver
General purpose Language Server that can use specified error message format generated from specified command.
Note: In order for neovim's built-in language server client to send the appropriate languageId to EFM, you must
specify filetypes in your call to setup{}. Otherwise lspconfig will launch EFM on the BufEnter instead
of the FileType autocommand, and the filetype variable used to populate the languageId will not yet be set.
require('lspconfig')['efm'].setup{
settings = ..., -- You must populate this according to the EFM readme
filetypes = { 'python','cpp','lua' }
}
Snippet to enable the language server:
require'lspconfig'.efm.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "efm-langserver" }
root_dir = util.root_pattern(".git")
single_file_support = false
elixirls
https://github.com/elixir-lsp/elixir-ls
elixir-ls can be installed by following the instructions here.
curl -fLO https://github.com/elixir-lsp/elixir-ls/releases/latest/download/elixir-ls.zip
unzip elixir-ls.zip -d /path/to/elixir-ls
# Unix
chmod +x /path/to/elixir-ls/language_server.sh
By default, elixir-ls doesn't have a cmd set. This is because nvim-lspconfig does not make assumptions about your path. You must add the following to your init.vim or init.lua to set cmd to the absolute path ($HOME and ~ are not expanded) of your unzipped elixir-ls.
require'lspconfig'.elixirls.setup{
-- Unix
cmd = { "/path/to/elixir-ls/language_server.sh" };
-- Windows
cmd = { "/path/to/elixir-ls/language_server.bat" };
...
}
This server accepts configuration via the settings key.
Available settings:
-
elixirLS.dialyzerEnabled:booleanDefault:
trueRun ElixirLS's rapid Dialyzer when code is saved
-
elixirLS.dialyzerFormat:enum { "dialyzer", "dialyxir_short", "dialyxir_long" }Default:
"dialyxir_long"Formatter to use for Dialyzer warnings
-
elixirLS.dialyzerWarnOpts:arrayDefault:
{}Array items:
{enum = { "error_handling", "no_behaviours", "no_contracts", "no_fail_call", "no_fun_app", "no_improper_lists", "no_match", "no_missing_calls", "no_opaque", "no_return", "no_undefined_callbacks", "no_unused", "underspecs", "unknown", "unmatched_returns", "overspecs", "specdiffs" },type = "string"}Dialyzer options to enable or disable warnings. See Dialyzer's documentation for options. Note that the "race_conditions" option is unsupported
-
elixirLS.enableTestLenses:booleanShow code lenses to run tests in terminal
-
elixirLS.fetchDeps:booleanAutomatically fetch project dependencies when compiling
-
elixirLS.mixEnv:stringDefault:
"test"Mix environment to use for compilation
-
elixirLS.mixTarget:stringMix target to use for compilation (requires Elixir >= 1.8)
-
elixirLS.projectDir:stringDefault:
""Subdirectory containing Mix project if not in the project root
-
elixirLS.signatureAfterComplete:booleanDefault:
trueShow signature help after confirming autocomplete
-
elixirLS.suggestSpecs:booleanDefault:
trueSuggest @spec annotations inline using Dialyzer's inferred success typings (Requires Dialyzer)
-
elixirLS.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VS Code and the Elixir language server.
Snippet to enable the language server:
require'lspconfig'.elixirls.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "elixir", "eelixir" }
root_dir = root_pattern("mix.exs", ".git") or vim.loop.os_homedir()
elmls
https://github.com/elm-tooling/elm-language-server#installation
If you don't want to use Nvim to install it, then you can use:
npm install -g elm elm-test elm-format @elm-tooling/elm-language-server
This server accepts configuration via the settings key.
Available settings:
-
elmLS.disableElmLSDiagnostics:booleanDisable linting diagnostics from the language server.
-
elmLS.elmFormatPath:stringDefault:
""The path to your elm-format executable. Should be empty by default, in that case it will assume the name and try to first get it from a local npm installation or a global one. If you set it manually it will not try to load from the npm folder.
-
elmLS.elmPath:stringDefault:
""The path to your elm executable. Should be empty by default, in that case it will assume the name and try to first get it from a local npm installation or a global one. If you set it manually it will not try to load from the npm folder.
-
elmLS.elmReviewDiagnostics:enum { "off", "warning", "error" }Default:
"off"Set severity or disable linting diagnostics for elm-review.
-
elmLS.elmReviewPath:stringDefault:
""The path to your elm-review executable. Should be empty by default, in that case it will assume the name and try to first get it from a local npm installation or a global one. If you set it manually it will not try to load from the npm folder.
-
elmLS.elmTestPath:stringDefault:
""The path to your elm-test executable. Should be empty by default, in that case it will assume the name and try to first get it from a local npm installation or a global one. If you set it manually it will not try to load from the npm folder.
-
elmLS.elmTestRunner.showElmTestOutput:booleanShow output of elm-test as terminal task
-
elmLS.onlyUpdateDiagnosticsOnSave:booleanOnly update compiler diagnostics on save, not on document change.
-
elmLS.skipInstallPackageConfirmation:booleanSkips confirmation for the Install Package code action.
-
elmLS.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VS Code and the language server.
Snippet to enable the language server:
require'lspconfig'.elmls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "elm-language-server" }
filetypes = { "elm" }
init_options = {
elmAnalyseTrigger = "change",
elmFormatPath = "elm-format",
elmPath = "elm",
elmTestPath = "elm-test"
}
root_dir = root_pattern("elm.json")
ember
https://github.com/lifeart/ember-language-server
ember-language-server can be installed via npm:
npm install -g @lifeart/ember-language-server
Snippet to enable the language server:
require'lspconfig'.ember.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ember-language-server", "--stdio" }
filetypes = { "handlebars", "typescript", "javascript" }
root_dir = root_pattern("ember-cli-build.js", ".git")
emmet_ls
https://github.com/aca/emmet-ls
Package can be installed via npm:
npm install -g emmet-ls
Snippet to enable the language server:
require'lspconfig'.emmet_ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "emmet-ls", "--stdio" }
filetypes = { "html", "css" }
root_dir = git root
erlangls
Language Server for Erlang.
Clone erlang_ls
Compile the project with make and copy resulting binaries somewhere in your $PATH eg. cp _build/*/bin/* ~/local/bin
Installation instruction can be found here.
Installation requirements: - Erlang OTP 21+ - rebar3 3.9.1+
Snippet to enable the language server:
require'lspconfig'.erlangls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "erlang_ls" }
filetypes = { "erlang" }
root_dir = root_pattern('rebar.config', 'erlang.mk', '.git')
single_file_support = true
esbonio
https://github.com/swyddfa/esbonio
Esbonio is a language server for Sphinx documentation projects. The language server can be installed via pip
pip install esbonio
Since Sphinx is highly extensible you will get best results if you install the language server in the same
Python environment as the one used to build your documentation. To ensure that the correct Python environment
is picked up, you can either launch nvim with the correct environment activated.
source env/bin/activate
nvim
Or you can modify the default cmd to include the full path to the Python interpreter.
require'lspconfig'.esbonio.setup {
cmd = { '/path/to/virtualenv/bin/python', '-m', 'esbonio' }
}
Esbonio supports a number of config values passed as init_options on startup, for example.
require'lspconfig'.esbonio.setup {
init_options = {
server = {
logLevel = "debug"
},
sphinx = {
confDir = "/path/to/docs",
srcDir = "${confDir}/../docs-src"
}
}
A full list and explanation of the available options can be found here
Snippet to enable the language server:
require'lspconfig'.esbonio.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "python3", "-m", "esbonio" }
filetypes = { "rst" }
root_dir = function(path)
-- Support git directories and git files (worktrees)
if M.path.is_dir(M.path.join(path, '.git')) or M.path.is_file(M.path.join(path, '.git')) then
return path
end
end)
end
eslint
https://github.com/hrsh7th/vscode-langservers-extracted
vscode-eslint-language-server: A linting engine for JavaScript / Typescript
vscode-eslint-language-server can be installed via npm:
npm i -g vscode-langservers-extracted
vscode-eslint-language-server provides an EslintFixAll command that can be used to format document on save
autocmd BufWritePre <buffer> <cmd>EslintFixAll<CR>
See vscode-eslint for configuration options.
Additional messages you can handle: eslint/noConfig Messages already handled in lspconfig: eslint/openDoc, eslint/confirmESLintExecution, eslint/probeFailed, eslint/noLibrary
Snippet to enable the language server:
require'lspconfig'.eslint.setup{}
Commands and default values:
Commands:
- EslintFixAll: Fix all eslint problems for this buffer
Default Values:
cmd = { "vscode-eslint-language-server", "--stdio" }
filetypes = { "javascript", "javascriptreact", "javascript.jsx", "typescript", "typescriptreact", "typescript.tsx", "vue" }
handlers = {
["eslint/confirmESLintExecution"] = <function 1>,
["eslint/noLibrary"] = <function 2>,
["eslint/openDoc"] = <function 3>,
["eslint/probeFailed"] = <function 4>
}
on_new_config = function(config, new_root_dir)
-- The "workspaceFolder" is a VSCode concept. It limits how far the
-- server will traverse the file system when locating the ESLint config
-- file (e.g., .eslintrc).
config.settings.workspaceFolder = {
uri = new_root_dir,
name = vim.fn.fnamemodify(new_root_dir, ':t'),
}
end,
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {
codeAction = {
disableRuleComment = {
enable = true,
location = "separateLine"
},
showDocumentation = {
enable = true
}
},
codeActionOnSave = {
enable = false,
mode = "all"
},
format = true,
nodePath = "",
onIgnoredFiles = "off",
packageManager = "npm",
quiet = false,
rulesCustomizations = {},
run = "onType",
useESLintClass = false,
validate = "on",
workingDirectory = {
mode = "location"
}
}
flow
https://flow.org/ https://github.com/facebook/flow
See below for how to setup Flow itself. https://flow.org/en/docs/install/
See below for lsp command options.
npx flow lsp --help
This server accepts configuration via the settings key.
Available settings:
-
flow.coverageSeverity:enum { "error", "warn", "info" }Default:
"info"Type coverage diagnostic severity
-
flow.enabled:booleanDefault:
trueIs flow enabled
-
flow.lazyMode:stringDefault:
vim.NILSet value to enable flow lazy mode
-
flow.logLevel:enum { "error", "warn", "info", "trace" }Default:
"info"Log level for output panel logs
-
flow.pathToFlow:stringDefault:
"flow"Absolute path to flow binary. Special var ${workspaceFolder} or ${flowconfigDir} can be used in path (NOTE: in windows you can use '/' and can omit '.cmd' in path)
-
flow.runOnEdit:booleanDefault:
trueIf true will run flow on every edit, otherwise will run only when changes are saved (Note: 'useLSP: true' only supports syntax errors)
-
flow.showUncovered:booleanIf true will show uncovered code by default
-
flow.stopFlowOnExit:booleanDefault:
trueStop Flow on Exit
-
flow.trace.serverDefault:
"off"Traces the communication between VSCode and the flow lsp service.
-
flow.useBundledFlow:booleanDefault:
trueIf true will use flow bundled with this plugin if nothing works
-
flow.useCodeSnippetOnFunctionSuggest:booleanDefault:
trueComplete functions with their parameter signature.
-
flow.useNPMPackagedFlow:booleanDefault:
trueSupport using flow through your node_modules folder, WARNING: Checking this box is a security risk. When you open a project we will immediately run code contained within it.
Snippet to enable the language server:
require'lspconfig'.flow.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "npx", "--no-install", "flow", "lsp" }
filetypes = { "javascript", "javascriptreact", "javascript.jsx" }
root_dir = root_pattern(".flowconfig")
flux-lsp
https://github.com/influxdata/flux-lsp
flux-lsp can be installed via cargo:
cargo install --git https://github.com/influxdata/flux-lsp
Snippet to enable the language server:
require'lspconfig'.flux-lsp.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "flux-lsp" }
filetypes = { "flux" }
root_dir = util.find_git_ancestor
fortls
https://github.com/hansec/fortran-language-server
Fortran Language Server for the Language Server Protocol
This server accepts configuration via the settings key.
Available settings:
-
fortran-ls.autocompletePrefix:booleanFilter autocomplete suggestions with variable prefix
-
fortran-ls.disableDiagnostics:booleanDisable diagnostics (requires v1.12.0+).
-
fortran-ls.displayVerWarning:booleanDefault:
trueProvides notifications when the underlying language server is out of date.
-
fortran-ls.enableCodeActions:booleanEnable experimental code actions (requires v1.7.0+).
-
fortran-ls.executablePath:stringDefault:
"fortls"Path to the Fortran language server (fortls).
-
fortran-ls.hoverSignature:booleanShow signature information in hover for argument (also enables 'variableHover').
-
fortran-ls.includeSymbolMem:booleanDefault:
trueInclude type members in document outline (also used for 'Go to Symbol in File')
-
fortran-ls.incrementalSync:booleanDefault:
trueUse incremental synchronization for file changes.
-
fortran-ls.lowercaseIntrinsics:booleanUse lowercase for intrinsics and keywords in autocomplete requests.
-
fortran-ls.maxCommentLineLength:numberDefault:
-1Maximum comment line length (requires v1.8.0+).
-
fortran-ls.maxLineLength:numberDefault:
-1Maximum line length (requires v1.8.0+).
-
fortran-ls.notifyInit:booleanNotify when workspace initialization is complete (requires v1.7.0+).
-
fortran-ls.useSignatureHelp:booleanDefault:
trueUse signature help instead of snippets when available.
-
fortran-ls.variableHover:booleanShow hover information for variables.
Snippet to enable the language server:
require'lspconfig'.fortls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "fortls" }
filetypes = { "fortran" }
root_dir = root_pattern(".fortls")
settings = {
nthreads = 1
}
fsautocomplete
https://github.com/fsharp/FsAutoComplete
Language Server for F# provided by FsAutoComplete (FSAC).
FsAutoComplete requires the dotnet-sdk to be installed.
The preferred way to install FsAutoComplete is with dotnet tool install --global fsautocomplete.
Instructions to compile from source are found on the main repository.
You may also need to configure the filetype as Vim defaults to Forth for *.fs files:
autocmd BufNewFile,BufRead *.fs,*.fsx,*.fsi set filetype=fsharp
This is automatically done by plugins such as PhilT/vim-fsharp, fsharp/vim-fsharp, and adelarsq/neofsharp.vim.
Snippet to enable the language server:
require'lspconfig'.fsautocomplete.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "fsautocomplete", "--background-service-enabled" }
filetypes = { "fsharp" }
init_options = {
AutomaticWorkspaceInit = true
}
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
fstar
https://github.com/FStarLang/FStar
LSP support is included in FStar. Make sure fstar.exe is in your PATH.
Snippet to enable the language server:
require'lspconfig'.fstar.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "fstar.exe", "--lsp" }
filetypes = { "fstar" }
root_dir = util.find_git_ancestor
gdscript
https://github.com/godotengine/godot
Language server for GDScript, used by Godot Engine.
Snippet to enable the language server:
require'lspconfig'.gdscript.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "nc", "localhost", "6008" }
filetypes = { "gd", "gdscript", "gdscript3" }
root_dir = util.root_pattern("project.godot", ".git")
ghcide
https://github.com/digital-asset/ghcide
A library for building Haskell IDE tooling. "ghcide" isn't for end users now. Use "haskell-language-server" instead of "ghcide".
Snippet to enable the language server:
require'lspconfig'.ghcide.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ghcide", "--lsp" }
filetypes = { "haskell", "lhaskell" }
root_dir = root_pattern("stack.yaml", "hie-bios", "BUILD.bazel", "cabal.config", "package.yaml")
golangci_lint_ls
Combination of both lint server and client
https://github.com/nametake/golangci-lint-langserver https://github.com/golangci/golangci-lint
Installation of binaries needed is done via
go install github.com/nametake/golangci-lint-langserver@latest
go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.42.1
Snippet to enable the language server:
require'lspconfig'.golangci_lint_ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "golangci-lint-langserver" }
filetypes = { "go", "gomod" }
init_options = {
command = { "golangci-lint", "run", "--enable-all", "--disable", "lll", "--out-format", "json" }
}
root_dir = root_pattern('go.mod', '.git')
gopls
https://github.com/golang/tools/tree/master/gopls
Google's lsp server for golang.
Snippet to enable the language server:
require'lspconfig'.gopls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "gopls" }
filetypes = { "go", "gomod" }
root_dir = root_pattern("go.mod", ".git")
graphql
https://github.com/graphql/graphiql/tree/main/packages/graphql-language-service-cli
graphql-lsp can be installed via npm:
npm install -g graphql-language-service-cli
Snippet to enable the language server:
require'lspconfig'.graphql.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "graphql-lsp", "server", "-m", "stream" }
filetypes = { "graphql" }
root_dir = root_pattern('.git', '.graphqlrc*', '.graphql.config.*')
groovyls
https://github.com/prominic/groovy-language-server.git
Requirements:
- Linux/macOS (for now)
- Java 11+
groovyls can be installed by following the instructions here.
If you have installed groovy language server, you can set the cmd custom path as follow:
require'lspconfig'.groovyls.setup{
-- Unix
cmd = { "java", "-jar", "path/to/groovyls/groovy-language-server-all.jar" },
...
}
Snippet to enable the language server:
require'lspconfig'.groovyls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "java", "-jar", "groovy-language-server-all.jar" }
filetypes = { "groovy" }
root_dir = function(fname)
return util.root_pattern 'Jenkinsfile'(fname) or util.find_git_ancestor(fname)
end,
haxe_language_server
https://github.com/vshaxe/haxe-language-server
The Haxe language server can be built by running the following commands from the project's root directory:
npm install
npx lix run vshaxe-build -t language-server
This will create bin/server.js. Note that the server requires Haxe 3.4.0 or
higher.
After building the language server, set the cmd setting in your setup
function:
lspconfig.haxe_language_server.setup({
cmd = {"node", "path/to/bin/server.js"},
})
By default, an HXML compiler arguments file named build.hxml is expected in
your project's root directory. If your file is named something different,
specify it using the init_options.displayArguments setting.
Snippet to enable the language server:
require'lspconfig'.haxe_language_server.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "haxe-language-server" }
filetypes = { "haxe" }
init_options = {
displayArguments = { "build.hxml" }
}
root_dir = root_pattern("*.hxml")
settings = {
haxe = {
executable = "haxe"
}
}
hie
https://github.com/haskell/haskell-ide-engine
the following init_options are supported (see https://github.com/haskell/haskell-ide-engine#configuration):
init_options = {
languageServerHaskell = {
hlintOn = bool;
maxNumberOfProblems = number;
diagnosticsDebounceDuration = number;
liquidOn = bool (default false);
completionSnippetsOn = bool (default true);
formatOnImportOn = bool (default true);
formattingProvider = string (default "brittany", alternate "floskell");
}
}
This server accepts configuration via the settings key.
Available settings:
-
haskell.checkProject:booleanDefault:
trueWhether to typecheck the entire project on load. It could drive to bad perfomance in large projects.
-
haskell.formattingProvider:enum { "brittany", "floskell", "fourmolu", "ormolu", "stylish-haskell", "none" }Default:
"ormolu"The formatter to use when formatting a document or range. Ensure the plugin is enabled.
-
haskell.logFile:stringDefault:
""If set, redirects the logs to a file.
-
haskell.maxCompletions:integerDefault:
40Maximum number of completions sent to the editor.
-
haskell.openDocumentationInHackage:booleanDefault:
trueWhen opening 'Documentation' for external libraries, open in hackage by default. Set to false to instead open in vscode.
-
haskell.openSourceInHackage:booleanDefault:
trueWhen opening 'Source' for external libraries, open in hackage by default. Set to false to instead open in vscode.
-
haskell.plugin.class.globalOn:booleanDefault:
trueEnables type class plugin
-
haskell.plugin.eval.globalOn:booleanDefault:
trueEnables eval plugin
-
haskell.plugin.ghcide-completions.config.autoExtendOn:booleanDefault:
truenull
-
haskell.plugin.ghcide-completions.config.snippetsOn:booleanDefault:
truenull
-
haskell.plugin.ghcide-type-lenses.config.mode:enum { "always", "exported", "diagnostics" }Default:
trueControl how type lenses are shown
-
haskell.plugin.ghcide-type-lenses.globalOn:booleanDefault:
trueEnables type lenses plugin
-
haskell.plugin.haddockComments.globalOn:booleanDefault:
trueEnables haddock comments plugin
-
haskell.plugin.hlint.codeActionsOn:booleanDefault:
trueEnables hlint code actions (apply hints)
-
haskell.plugin.hlint.config.flags:arrayDefault:
{}null
-
haskell.plugin.hlint.diagnosticsOn:booleanDefault:
trueEnables hlint diagnostics
-
haskell.plugin.importLens.codeActionsOn:booleanDefault:
trueEnables explicit imports code actions
-
haskell.plugin.importLens.codeLensOn:booleanDefault:
trueEnables explicit imports code lenses
-
haskell.plugin.moduleName.globalOn:booleanDefault:
trueEnables module name plugin
-
haskell.plugin.pragmas.codeActionsOn:booleanDefault:
trueEnables pragmas code actions
-
haskell.plugin.pragmas.completionOn:booleanDefault:
trueEnables pragmas completions
-
haskell.plugin.refineImports.globalOn:booleanDefault:
trueEnables refine imports plugin
-
haskell.plugin.retrie.globalOn:booleanDefault:
trueEnables retrie plugin
-
haskell.plugin.splice.globalOn:booleanDefault:
trueEnables splice plugin (expand template haskell definitions)
-
haskell.plugin.tactics.config.auto_gas:integerDefault:
4null
-
haskell.plugin.tactics.config.hole_severity:enum { 1, 2, 3, 4, vim.NIL }Default:
vim.NILThe severity to use when showing hole diagnostics.
-
haskell.plugin.tactics.config.max_use_ctor_actions:integerDefault:
5null
-
haskell.plugin.tactics.config.proofstate_styling:booleanDefault:
truenull
-
haskell.plugin.tactics.config.timeout_duration:integerDefault:
2null
-
haskell.plugin.tactics.globalOn:booleanDefault:
trueEnables Wingman (tactics) plugin
-
haskell.releasesDownloadStoragePath:stringDefault:
""null
-
haskell.releasesURL:stringDefault:
""An optional URL to override where to check for haskell-language-server releases
-
haskell.serverEnvironment:objectDefault:
vim.empty_dict()null
-
haskell.serverExecutablePath:stringDefault:
""null
-
haskell.serverExtraArgs:stringDefault:
""null
-
haskell.trace.client:enum { "off", "error", "info", "debug" }Default:
"info"Sets the log level in the client side.
-
haskell.trace.server:enum { "off", "messages" }Default:
"off"Traces the communication between VS Code and the language server.
-
haskell.updateBehavior:enum { "keep-up-to-date", "prompt", "never-check" }Default:
"keep-up-to-date"null
Snippet to enable the language server:
require'lspconfig'.hie.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "hie-wrapper", "--lsp" }
filetypes = { "haskell" }
root_dir = root_pattern("stack.yaml", "package.yaml", ".git")
hls
https://github.com/haskell/haskell-language-server
Haskell Language Server
Snippet to enable the language server:
require'lspconfig'.hls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "haskell-language-server-wrapper", "--lsp" }
filetypes = { "haskell", "lhaskell" }
lspinfo = function on_stdout(_, data, _)
local version = data[1]
table.insert(extra, 'version: ' .. version)
end
local opts = {
cwd = cfg.cwd,
stdout_buffered = true,
on_stdout = on_stdout,
}
local chanid = vim.fn.jobstart({ cfg.cmd[1], '--version' }, opts)
vim.fn.jobwait { chanid }
return extra
end,
root_dir = root_pattern("*.cabal", "stack.yaml", "cabal.project", "package.yaml", "hie.yaml")
settings = {
haskell = {
formattingProvider = "ormolu"
}
}
html
https://github.com/hrsh7th/vscode-langservers-extracted
vscode-html-language-server can be installed via npm:
npm i -g vscode-langservers-extracted
Neovim does not currently include built-in snippets. vscode-html-language-server only provides completions when snippet support is enabled.
To enable completion, install a snippet plugin and add the following override to your language client capabilities during setup.
--Enable (broadcasting) snippet capability for completion
local capabilities = vim.lsp.protocol.make_client_capabilities()
capabilities.textDocument.completion.completionItem.snippetSupport = true
require'lspconfig'.html.setup {
capabilities = capabilities,
}
Snippet to enable the language server:
require'lspconfig'.html.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "vscode-html-language-server", "--stdio" }
filetypes = { "html" }
init_options = {
configurationSection = { "html", "css", "javascript" },
embeddedLanguages = {
css = true,
javascript = true
}
}
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {}
single_file_support = true
idris2_lsp
https://github.com/idris-community/idris2-lsp
The Idris 2 language server.
Plugins for the Idris 2 filetype include Idris2-Vim (fewer features, stable) and Nvim-Idris2 (cutting-edge, experimental).
Idris2-Lsp requires a build of Idris 2 that includes the "Idris 2 API" package. Package managers with known support for this build include the AUR and Homebrew.
If your package manager does not support the Idris 2 API, you will need to build Idris 2 from source. Refer to the the Idris 2 installation instructions for details. Steps 5 and 8 are listed as "optional" in that guide, but they are necessary in order to make the Idris 2 API available.
You need to install a version of Idris2-Lsp that is compatible with your version of Idris 2. There should be a branch corresponding to every released Idris 2 version after v0.4.0. Use the latest commit on that branch. For example, if you have Idris v0.5.1, you should use the v0.5.1 branch of Idris2-Lsp.
If your Idris 2 version is newer than the newest Idris2-Lsp branch, use the
latest commit on the master branch, and set a reminder to check the Idris2-Lsp
repo for the release of a compatible versioned branch.
Snippet to enable the language server:
require'lspconfig'.idris2_lsp.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "idris2-lsp" }
filetypes = { "idris2" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
intelephense
intelephense can be installed via npm:
npm install -g intelephense
Snippet to enable the language server:
require'lspconfig'.intelephense.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "intelephense", "--stdio" }
filetypes = { "php" }
root_dir = root_pattern("composer.json", ".git")
java_language_server
https://github.com/georgewfraser/java-language-server
Java language server
Point cmd to lang_server_linux.sh or the equivalent script for macOS/Windows provided by java-language-server
This server accepts configuration via the settings key.
Available settings:
-
java.addExports:arrayArray items:
{type = "string"}List of modules to allow access to, for example ["jdk.compiler/com.sun.tools.javac.api"]
-
java.classPath:arrayArray items:
{type = "string"}Relative paths from workspace root to .jar files, .zip files, or folders that should be included in the Java class path
-
java.debugTestMethod:arrayArray items:
{type = "string"}Command to debug one test method, for example ["mvn", "test", "-Dmaven.surefire.debug", "-Dtest=${class}#${method}". The test should start paused, listening for the debugger on port 5005.
-
java.externalDependencies:arrayArray items:
{pattern = "^[^:]+:[^:]+:[^:]+(:[^:]+:[^:]+)?$",type = "string"}External dependencies of the form groupId:artifactId:version or groupId:artifactId:packaging:version:scope
-
java.home:stringAbsolute path to your Java home directory
-
java.testClass:arrayArray items:
{type = "string"}Command to run all tests in a class, for example ["mvn", "test", "-Dtest=${class}"
-
java.testMethod:arrayArray items:
{type = "string"}Command to run one test method, for example ["mvn", "test", "-Dtest=${class}#${method}"
-
java.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VSCode and the language server.
Snippet to enable the language server:
require'lspconfig'.java_language_server.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "java" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {}
jdtls
https://projects.eclipse.org/projects/eclipse.jdt.ls
Language server for Java.
IMPORTANT: If you want all the features jdtls has to offer, nvim-jdtls is highly recommended. If all you need is diagnostics, completion, imports, gotos and formatting and some code actions you can keep reading here.
For manual installation you can download precompiled binaries from the official downloads site
Due to the nature of java, settings cannot be inferred. Please set the following environmental variables to match your installation. If you need per-project configuration direnv is highly recommended.
# Mandatory:
# .bashrc
export JDTLS_HOME=/path/to/jdtls_root # Directory with the plugin and configs directories
# Optional:
export JAVA_HOME=/path/to/java_home # In case you don't have java in path or want to use a version in particular
export WORKSPACE=/path/to/workspace # Defaults to $HOME/workspace
-- init.lua
require'lspconfig'.jdtls.setup{}
For automatic installation you can use the following unofficial installers/launchers under your own risk:
- jdtls-launcher (Includes lombok support by default)
-- init.lua require'lspconfig'.jdtls.setup{ cmd = { 'jdtls' } }
This server accepts configuration via the settings key.
Available settings:
-
java.autobuild.enabled:booleanDefault:
trueEnable/disable the 'auto build'
-
java.codeGeneration.generateComments:booleanGenerate method comments when generating the methods.
-
java.codeGeneration.hashCodeEquals.useInstanceof:booleanUse 'instanceof' to compare types when generating the hashCode and equals methods.
-
java.codeGeneration.hashCodeEquals.useJava7Objects:booleanUse Objects.hash and Objects.equals when generating the hashCode and equals methods. This setting only applies to Java 7 and higher.
-
java.codeGeneration.insertionLocation:enum { "afterCursor", "beforeCursor", "lastMember" }Default:
"afterCursor"Specifies the insertion location of the code generated by source actions.
-
java.codeGeneration.toString.codeStyle:enum { "STRING_CONCATENATION", "STRING_BUILDER", "STRING_BUILDER_CHAINED", "STRING_FORMAT" }Default:
"STRING_CONCATENATION"The code style for generating the toString method.
-
java.codeGeneration.toString.limitElements:integerDefault:
0Limit number of items in arrays/collections/maps to list, if 0 then list all.
-
java.codeGeneration.toString.listArrayContents:booleanDefault:
trueList contents of arrays instead of using native toString().
-
java.codeGeneration.toString.skipNullValues:booleanSkip null values when generating the toString method.
-
java.codeGeneration.toString.template:stringDefault:
"${object.className} [${member.name()}=${member.value}, ${otherMembers}]"The template for generating the toString method.
-
java.codeGeneration.useBlocks:booleanUse blocks in 'if' statements when generating the methods.
-
java.completion.enabled:booleanDefault:
trueEnable/disable code completion support
-
java.completion.favoriteStaticMembers:arrayDefault:
{ "org.junit.Assert.*", "org.junit.Assume.*", "org.junit.jupiter.api.Assertions.*", "org.junit.jupiter.api.Assumptions.*", "org.junit.jupiter.api.DynamicContainer.*", "org.junit.jupiter.api.DynamicTest.*", "org.mockito.Mockito.*", "org.mockito.ArgumentMatchers.*", "org.mockito.Answers.*" }Defines a list of static members or types with static members. Content assist will propose those static members even if the import is missing.
-
java.completion.filteredTypes:arrayDefault:
{ "java.awt.*", "com.sun.*", "sun.*", "jdk.*", "org.graalvm.*", "io.micrometer.shaded.*" }Defines the type filters. All types whose fully qualified name matches the selected filter strings will be ignored in content assist or quick fix proposals and when organizing imports. For example 'java.awt.*' will hide all types from the awt packages.
-
java.completion.guessMethodArguments:booleanWhen set to true, method arguments are guessed when a method is selected from as list of code assist proposals.
-
java.completion.importOrder:arrayDefault:
{ "java", "javax", "com", "org" }Defines the sorting order of import statements. A package or type name prefix (e.g. 'org.eclipse') is a valid entry. An import is always added to the most specific group.
-
java.completion.maxResults:integerDefault:
0null
-
java.completion.overwrite:booleanDefault:
trueWhen set to true, code completion overwrites the current text. When set to false, code is simply added instead.
-
java.configuration.checkProjectSettingsExclusions:booleanDefault:
trueControls whether to exclude extension-generated project settings files (.project, .classpath, .factorypath, .settings/) from the file explorer.
-
java.configuration.maven.globalSettings:stringDefault:
vim.NILPath to Maven's global settings.xml
-
java.configuration.maven.notCoveredPluginExecutionSeverity:enum { "ignore", "warning", "error" }Default:
"warning"Specifies severity if the plugin execution is not covered by Maven build lifecycle.
-
java.configuration.maven.userSettings:stringDefault:
vim.NILPath to Maven's user settings.xml
-
java.configuration.runtimes:arrayDefault:
{}Array items:
{additionalProperties = false,default = vim.empty_dict(),properties = {default = {description = "Is default runtime? Only one runtime can be default.",type = "boolean"},javadoc = {description = "JDK javadoc path.",type = "string"},name = {description = "Java Execution Environment name. Must be unique.",enum = { "J2SE-1.5", "JavaSE-1.6", "JavaSE-1.7", "JavaSE-1.8", "JavaSE-9", "JavaSE-10", "JavaSE-11", "JavaSE-12", "JavaSE-13", "JavaSE-14", "JavaSE-15", "JavaSE-16", "JavaSE-17" },type = "string"},path = {description = 'JDK home path. Should be the JDK installation directory, not the Java bin path.\n On Windows, backslashes must be escaped, i.e.\n"path":"C:\\\\Program Files\\\\Java\\\\jdk1.8.0_161".',pattern = ".*(?<!\\/bin|\\/bin\\/|\\\\bin|\\\\bin\\\\)$",type = "string"},sources = {description = "JDK sources path.",type = "string"}},required = { "path", "name" },type = "object"}Map Java Execution Environments to local JDKs.
-
java.configuration.updateBuildConfiguration:enum { "disabled", "interactive", "automatic" }Default:
"interactive"Specifies how modifications on build files update the Java classpath/configuration
-
java.configuration.workspaceCacheLimit:null|integerDefault:
vim.NILThe number of days (if enabled) to keep unused workspace cache data. Beyond this limit, cached workspace data may be removed.
-
java.contentProvider.preferred:stringDefault:
vim.NILPreferred content provider (a 3rd party decompiler id, usually)
-
java.eclipse.downloadSources:booleanEnable/disable download of Maven source artifacts for Eclipse projects.
-
java.errors.incompleteClasspath.severity:enum { "ignore", "info", "warning", "error" }Default:
"warning"Specifies the severity of the message when the classpath is incomplete for a Java file
-
java.foldingRange.enabled:booleanDefault:
trueEnable/disable smart folding range support. If disabled, it will use the default indentation-based folding range provided by VS Code.
-
java.format.comments.enabled:booleanDefault:
trueIncludes the comments during code formatting.
-
java.format.enabled:booleanDefault:
trueEnable/disable default Java formatter
-
java.format.onType.enabled:booleanDefault:
trueEnable/disable automatic block formatting when typing `;`, `<enter>` or `}`
-
java.format.settings.profile:stringDefault:
vim.NILOptional formatter profile name from the Eclipse formatter settings.
-
java.format.settings.url:stringDefault:
vim.NILnull
-
java.home:string|nullDefault:
vim.NILSpecifies the folder path to the JDK (11 or more recent) used to launch the Java Language Server. On Windows, backslashes must be escaped, i.e. "java.home":"C:\\Program Files\\Java\\jdk11.0_8"
-
java.implementationsCodeLens.enabled:booleanEnable/disable the implementations code lens.
-
java.import.exclusions:arrayDefault:
{ "**/node_modules/**", "**/.metadata/**", "**/archetype-resources/**", "**/META-INF/maven/**" }Configure glob patterns for excluding folders. Use `!` to negate patterns to allow subfolders imports. You have to include a parent directory. The order is important.
-
java.import.generatesMetadataFilesAtProjectRoot:booleannull
-
java.import.gradle.arguments:stringDefault:
vim.NILArguments to pass to Gradle.
-
java.import.gradle.enabled:booleanDefault:
trueEnable/disable the Gradle importer.
-
java.import.gradle.home:stringDefault:
vim.NILUse Gradle from the specified local installation directory or GRADLE_HOME if the Gradle wrapper is missing or disabled and no 'java.import.gradle.version' is specified.
-
java.import.gradle.java.home:stringDefault:
vim.NILThe location to the JVM used to run the Gradle daemon.
-
java.import.gradle.jvmArguments:stringDefault:
vim.NILJVM arguments to pass to Gradle.
-
java.import.gradle.offline.enabled:booleanEnable/disable the Gradle offline mode.
-
java.import.gradle.user.home:stringDefault:
vim.NILSetting for GRADLE_USER_HOME.
-
java.import.gradle.version:stringDefault:
vim.NILUse Gradle from the specific version if the Gradle wrapper is missing or disabled.
-
java.import.gradle.wrapper.enabled:booleanDefault:
trueUse Gradle from the 'gradle-wrapper.properties' file.
-
java.import.maven.enabled:booleanDefault:
trueEnable/disable the Maven importer.
-
java.imports.gradle.wrapper.checksums:arrayDefault:
{}Array items:
{additionalProperties = false,default = vim.empty_dict(),properties = {allowed = {default = true,label = "Is allowed?",type = "boolean"},sha256 = {label = "SHA-256 checksum.",type = "string"}},required = { "sha256" },type = "object",uniqueItems = true}Defines allowed/disallowed SHA-256 checksums of Gradle Wrappers
-
java.jdt.ls.vmargs:string|nullDefault:
"-XX:+UseParallelGC -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xmx1G -Xms100m"Specifies extra VM arguments used to launch the Java Language Server. Eg. use `-XX:+UseParallelGC -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xmx1G -Xms100m ` to optimize memory usage with the parallel garbage collector
-
java.maven.downloadSources:booleanEnable/disable download of Maven source artifacts as part of importing Maven projects.
-
java.maven.updateSnapshots:booleanForce update of Snapshots/Releases.
-
java.maxConcurrentBuilds:integerDefault:
1Max simultaneous project builds
-
java.progressReports.enabled:booleanDefault:
true[Experimental] Enable/disable progress reports from background processes on the server.
-
java.project.importHint:booleanDefault:
trueEnable/disable the server-mode switch information, when Java projects import is skipped on startup.
-
java.project.importOnFirstTimeStartup:enum { "disabled", "interactive", "automatic" }Default:
"automatic"Specifies whether to import the Java projects, when opening the folder in Hybrid mode for the first time.
-
java.project.outputPath:string|nullDefault:
""null
-
java.project.referencedLibraries:array|objectDefault:
{ "lib/**/*.jar" }Configure glob patterns for referencing local libraries to a Java project.
-
java.project.resourceFilters:arrayDefault:
{ "node_modules", ".git" }Excludes files and folders from being refreshed by the Java Language Server, which can improve the overall performance. For example, ["node_modules",".git"] will exclude all files and folders named 'node_modules' or '.git'. Defaults to ["node_modules",".git"].
-
java.project.sourcePaths:arrayDefault:
{}Array items:
{type = "string"}null
-
java.quickfix.showAt:enum { "line", "problem" }Default:
"line"Show quickfixes at the problem or line level.
-
java.recommendations.dependency.analytics.show:booleanDefault:
trueShow the recommended Dependency Analytics extension.
-
java.references.includeAccessors:booleanDefault:
trueInclude getter, setter and builder/constructor when finding references.
-
java.references.includeDecompiledSources:booleanDefault:
trueInclude the decompiled sources when finding references.
-
java.referencesCodeLens.enabled:booleanEnable/disable the references code lens.
-
java.saveActions.organizeImports:booleanEnable/disable auto organize imports on save action
-
java.selectionRange.enabled:booleanDefault:
trueEnable/disable Smart Selection support for Java. Disabling this option will not affect the VS Code built-in word-based and bracket-based smart selection.
-
java.server.launchMode:enum { "Standard", "LightWeight", "Hybrid" }Default:
"Hybrid"The launch mode for the Java extension
-
java.settings.url:stringDefault:
vim.NILnull
-
java.showBuildStatusOnStart.enabledDefault:
"notification"Automatically show build status on startup.
-
java.signatureHelp.enabled:booleanEnable/disable the signature help.
-
java.sources.organizeImports.starThreshold:integerDefault:
99Specifies the number of imports added before a star-import declaration is used.
-
java.sources.organizeImports.staticStarThreshold:integerDefault:
99Specifies the number of static imports added before a star-import declaration is used.
-
java.symbols.includeSourceMethodDeclarations:booleannull
-
java.templates.fileHeader:arrayDefault:
{}null
-
java.templates.typeComment:arrayDefault:
{}null
-
java.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VS Code and the Java language server.
-
java.typeHierarchy.lazyLoad:booleanEnable/disable lazy loading the content in type hierarchy. Lazy loading could save a lot of loading time but every type should be expanded manually to load its content.
Snippet to enable the language server:
require'lspconfig'.jdtls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "/usr/lib/jvm/adoptopenjdk-11-hotspot-amd64/bin/java", "-Declipse.application=org.eclipse.jdt.ls.core.id1", "-Dosgi.bundles.defaultStartLevel=4", "-Declipse.product=org.eclipse.jdt.ls.core.product", "-Dlog.protocol=true", "-Dlog.level=ALL", "-Xms1g", "-Xmx2G", "--add-modules=ALL-SYSTEM", "--add-opens", "java.base/java.util=ALL-UNNAMED", "--add-opens", "java.base/java.lang=ALL-UNNAMED", "-jar", "/plugins/org.eclipse.equinox.launcher_*.jar", "-configuration", "config_linux", "-data", "/home/runner/workspace" }
filetypes = { "java" }
handlers = {
["language/status"] = <function 1>,
["textDocument/codeAction"] = <function 2>,
["textDocument/rename"] = <function 3>,
["workspace/applyEdit"] = <function 4>
}
init_options = {
jvm_args = {},
workspace = "/home/runner/workspace"
}
root_dir = {
-- Single-module projects
{
'build.xml', -- Ant
'pom.xml', -- Maven
'settings.gradle', -- Gradle
'settings.gradle.kts', -- Gradle
},
-- Multi-module projects
{ 'build.gradle', 'build.gradle.kts' },
} or vim.fn.getcwd()
single_file_support = true
jedi_language_server
https://github.com/pappasam/jedi-language-server
jedi-language-server, a language server for Python, built on top of jedi
Snippet to enable the language server:
require'lspconfig'.jedi_language_server.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "jedi-language-server" }
filetypes = { "python" }
root_dir = vim's starting directory
single_file_support = true
jsonls
https://github.com/hrsh7th/vscode-langservers-extracted
vscode-json-language-server, a language server for JSON and JSON schema
vscode-json-language-server can be installed via npm:
npm i -g vscode-langservers-extracted
vscode-json-language-server only provides range formatting. You can map a command that applies range formatting to the entire document:
require'lspconfig'.jsonls.setup {
commands = {
Format = {
function()
vim.lsp.buf.range_formatting({},{0,0},{vim.fn.line("$"),0})
end
}
}
}
Neovim does not currently include built-in snippets. vscode-json-language-server only provides completions when snippet support is enabled. To enable completion, install a snippet plugin and add the following override to your language client capabilities during setup.
--Enable (broadcasting) snippet capability for completion
local capabilities = vim.lsp.protocol.make_client_capabilities()
capabilities.textDocument.completion.completionItem.snippetSupport = true
require'lspconfig'.jsonls.setup {
capabilities = capabilities,
}
This server accepts configuration via the settings key.
Available settings:
-
json.colorDecorators.enable:booleanDefault:
true%json.colorDecorators.enable.desc%
-
json.format.enable:booleanDefault:
true%json.format.enable.desc%
-
json.maxItemsComputed:numberDefault:
5000%json.maxItemsComputed.desc%
-
json.schemaDownload.enable:booleanDefault:
true%json.enableSchemaDownload.desc%
-
json.schemas:arrayArray items:
{default = {fileMatch = { "/myfile" },url = "schemaURL"},properties = {fileMatch = {description = "%json.schemas.fileMatch.desc%",items = {default = "MyFile.json",description = "%json.schemas.fileMatch.item.desc%",type = "string"},minItems = 1,type = "array"},schema = {["$ref"] = "http://json-schema.org/draft-07/schema#",description = "%json.schemas.schema.desc%"},url = {default = "/user.schema.json",description = "%json.schemas.url.desc%",type = "string"}},type = "object"}%json.schemas.desc%
-
json.trace.server:enum { "off", "messages", "verbose" }Default:
"off"%json.tracing.desc%
Snippet to enable the language server:
require'lspconfig'.jsonls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "vscode-json-language-server", "--stdio" }
filetypes = { "json" }
init_options = {
provideFormatter = true
}
root_dir = util.find_git_ancestor
single_file_support = true
jsonnet_ls
https://github.com/jdbaldry/jsonnet-language-server
A Language Server Protocol (LSP) server for Jsonnet.
Snippet to enable the language server:
require'lspconfig'.jsonnet_ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "jsonnet-language-server" }
filetypes = { "jsonnet", "libsonnet" }
on_new_config = function(new_config, root_dir)
new_config.cmd_env = {
JSONNET_PATH = jsonnet_path(root_dir),
}
end,
root_dir = root_pattern("jsonnetfile.json")
julials
https://github.com/julia-vscode/julia-vscode
LanguageServer.jl can be installed with julia and Pkg:
julia --project=~/.julia/environments/nvim-lspconfig -e 'using Pkg; Pkg.add("LanguageServer")'
where ~/.julia/environments/nvim-lspconfig is the location where
the default configuration expects LanguageServer.jl to be installed.
To update an existing install, use the following command:
julia --project=~/.julia/environments/nvim-lspconfig -e 'using Pkg; Pkg.update()'
Note: In order to have LanguageServer.jl pick up installed packages or dependencies in a Julia project, you must make sure that the project is instantiated:
julia --project=/path/to/my/project -e 'using Pkg; Pkg.instantiate()'
This server accepts configuration via the settings key.
Available settings:
-
julia.NumThreads:integer|nullDefault:
vim.NILNumber of threads to use for Julia processes.
-
julia.additionalArgs:arrayDefault:
{}Additional Julia arguments.
-
julia.cellDelimiters:arrayDefault:
{ "^##(?!#)", "^#(\\s?)%%", "^#-" }Cell delimiter regular expressions for Julia files.
-
julia.completionmode:enum { "exportedonly", "import", "qualify" }Default:
"qualify"Sets the mode for completions.
-
julia.debuggerDefaultCompiled:arrayDefault:
{ "Base.", "-Base.!", "-Base.all", "-Base.all!", "-Base.any", "-Base.any!", "-Base.cd", "-Base.iterate", "-Base.collect", "-Base.collect_similar", "-Base._collect", "-Base.collect_to!", "-Base.collect_to_with_first!", "-Base.filter", "-Base.filter!", "-Base.foreach", "-Base.findall", "-Base.findfirst", "-Base.findlast", "-Base.findnext", "-Base.findprev", "-Base.Generator", "-Base.map", "-Base.map!", "-Base.maximum!", "-Base.minimum!", "-Base.mktemp", "-Base.mktempdir", "-Base.open", "-Base.prod!", "-Base.redirect_stderr", "-Base.redirect_stdin", "-Base.redirect_stdout", "-Base.reenable_sigint", "-Base.setindex!", "-Base.setprecision", "-Base.setrounding", "-Base.show", "-Base.sprint", "-Base.sum", "-Base.sum!", "-Base.task_local_storage", "-Base.timedwait", "-Base.withenv", "-Base.Broadcast", "Core", "Core.Compiler.", "Core.IR", "Core.Intrinsics", "DelimitedFiles", "Distributed", "LinearAlgebra.", "Serialization", "Statistics", "-Statistics.mean", "SparseArrays", "Mmap" }Functions or modules that are set to compiled mode when setting the defaults.
-
julia.deleteJuliaCovFiles:booleanDefault:
"true"Delete Julia .cov files when running tests with coverage, leaving only a .lcov file behind.
-
julia.editor:string|nullDefault:
vim.NILnull
-
julia.enableCrashReporter:boolean|nullDefault:
vim.NILEnable crash reports to be sent to the julia VS Code extension developers.
-
julia.enableTelemetry:boolean|nullDefault:
vim.NILEnable usage data and errors to be sent to the julia VS Code extension developers.
-
julia.environmentPath:string|nullDefault:
vim.NILPath to a julia environment. VS Code needs to be reloaded for changes to take effect.
-
julia.executablePath:stringDefault:
""Points to the julia executable.
-
julia.execution.codeInREPL:booleanPrint executed code in REPL and append it to the REPL history.
-
julia.execution.inlineResults.colors:objectDefault:
vim.empty_dict()null
-
julia.execution.resultType:enum { "REPL", "inline", "inline, errors in REPL", "both" }Default:
"both"Specifies how to show inline execution results
-
julia.focusPlotNavigator:booleanWhether to automatically show the plot navigator when plotting.
-
julia.lint.call:booleanDefault:
trueThis compares call signatures against all known methods for the called function. Calls with too many or too few arguments, or unknown keyword parameters are highlighted.
-
julia.lint.constif:booleanDefault:
trueCheck for constant conditionals in if statements that result in branches never being reached..
-
julia.lint.datadecl:booleanDefault:
trueCheck variables used in type declarations are datatypes.
-
julia.lint.disabledDirs:arrayDefault:
{ "docs", "test" }null
-
julia.lint.iter:booleanDefault:
trueCheck iterator syntax of loops. Will identify, for example, attempts to iterate over single values.
-
julia.lint.lazy:booleanDefault:
trueCheck for deterministic lazy boolean operators.
-
julia.lint.missingrefs:enum { "none", "symbols", "all" }Default:
"none"Highlight unknown symbols. The `symbols` option will not mark unknown fields.
-
julia.lint.modname:booleanDefault:
trueCheck submodule names do not shadow their parent's name.
-
julia.lint.nothingcomp:booleanDefault:
trueCheck for use of `==` rather than `===` when comparing against `nothing`.
-
julia.lint.pirates:booleanDefault:
trueCheck for type piracy - the overloading of external functions with methods specified for external datatypes. 'External' here refers to imported code.
-
julia.lint.run:booleanDefault:
trueRun the linter on active files.
-
julia.lint.typeparam:booleanDefault:
trueCheck parameters declared in `where` statements or datatype declarations are used.
-
julia.lint.useoffuncargs:booleanDefault:
trueCheck that all declared arguments are used within the function body.
-
julia.liveTestFile:stringDefault:
"test/runtests.jl"A workspace relative path to a Julia file that contains the tests that should be run for live testing.
-
julia.packageServer:stringDefault:
""null
-
julia.persistentSession.enabled:booleannull
-
julia.persistentSession.shell:stringDefault:
"/bin/sh"Shell used to start the persistent session.
-
julia.persistentSession.shellExecutionArgument:stringDefault:
"-c"null
-
julia.persistentSession.tmuxSessionName:stringDefault:
"julia_vscode"null
-
julia.plots.path:stringThe output directory to save plots to
-
julia.runtimeCompletions:booleanRequest runtime completions from the integrated REPL.
-
julia.showRuntimeDiagnostics:booleanDefault:
truenull
-
julia.symbolCacheDownload:boolean|nullDefault:
vim.NILDownload symbol server cache files from GitHub.
-
julia.symbolserverUpstream:stringDefault:
"https://www.julia-vscode.org/symbolcache"Symbol server cache download URL.
-
julia.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VS Code and the language server.
-
julia.useCustomSysimage:booleanUse an existing custom sysimage when starting the REPL
-
julia.usePlotPane:booleanDefault:
trueDisplay plots within VS Code. Might require a restart of the Julia process.
-
julia.useProgressFrontend:booleanDefault:
truenull
-
julia.useRevise:booleanDefault:
trueLoad Revise.jl on startup of the REPL.
Snippet to enable the language server:
require'lspconfig'.julials.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "julia", "--startup-file=no", "--history-file=no", "-e", ' # Load LanguageServer.jl: attempt to load from ~/.julia/environments/nvim-lspconfig\n # with the regular load path as a fallback\n ls_install_path = joinpath(\n get(DEPOT_PATH, 1, joinpath(homedir(), ".julia")),\n "environments", "nvim-lspconfig"\n )\n pushfirst!(LOAD_PATH, ls_install_path)\n using LanguageServer\n popfirst!(LOAD_PATH)\n depot_path = get(ENV, "JULIA_DEPOT_PATH", "")\n project_path = let\n dirname(something(\n ## 1. Finds an explicitly set project (JULIA_PROJECT)\n Base.load_path_expand((\n p = get(ENV, "JULIA_PROJECT", nothing);\n p === nothing ? nothing : isempty(p) ? nothing : p\n )),\n ## 2. Look for a Project.toml file in the current working directory,\n ## or parent directories, with $HOME as an upper boundary\n Base.current_project(),\n ## 3. First entry in the load path\n get(Base.load_path(), 1, nothing),\n ## 4. Fallback to default global environment,\n ## this is more or less unreachable\n Base.load_path_expand("@v#.#"),\n ))\n end\n @info "Running language server" VERSION pwd() project_path depot_path\n server = LanguageServer.LanguageServerInstance(stdin, stdout, project_path, depot_path)\n server.runlinter = true\n run(server)\n ' }
filetypes = { "julia" }
root_dir = function(fname)
return util.root_pattern 'Project.toml'(fname) or util.find_git_ancestor(fname)
end,
single_file_support = true
kotlin_language_server
A kotlin language server which was developed for internal usage and
released afterwards. Maintaining is not done by the original author,
but by fwcd.
It is built via gradle and developed on github.
Source and additional description:
https://github.com/fwcd/kotlin-language-server
This server requires vim to be aware of the kotlin-filetype.
You could refer for this capability to:
https://github.com/udalov/kotlin-vim (recommended)
Note that there is no LICENSE specified yet.
This server accepts configuration via the settings key.
Available settings:
-
kotlin.compiler.jvm.target:stringDefault:
"default"Specifies the JVM target, e.g. "1.6" or "1.8"
-
kotlin.completion.snippets.enabled:booleanDefault:
trueSpecifies whether code completion should provide snippets (true) or plain-text items (false).
-
kotlin.debounceTime:integerDefault:
250[DEPRECATED] Specifies the debounce time limit. Lower to increase responsiveness at the cost of possible stability issues.
-
kotlin.debugAdapter.enabled:booleanDefault:
true[Recommended] Specifies whether the debug adapter should be used. When enabled a debugger for Kotlin will be available.
-
kotlin.debugAdapter.path:stringDefault:
""Optionally a custom path to the debug adapter executable.
-
kotlin.externalSources.autoConvertToKotlin:booleanDefault:
trueSpecifies whether decompiled/external classes should be auto-converted to Kotlin.
-
kotlin.externalSources.useKlsScheme:booleanDefault:
true[Recommended] Specifies whether URIs inside JARs should be represented using the 'kls'-scheme.
-
kotlin.indexing.enabled:booleanDefault:
trueWhether global symbols in the project should be indexed automatically in the background. This enables e.g. code completion for unimported classes and functions.
-
kotlin.languageServer.debugAttach.autoSuspend:boolean[DEBUG] If enabled (together with debugAttach.enabled), the language server will not immediately launch but instead listen on the specified attach port and wait for a debugger. This is ONLY useful if you need to debug the language server ITSELF.
-
kotlin.languageServer.debugAttach.enabled:boolean[DEBUG] Whether the language server should listen for debuggers, i.e. be debuggable while running in VSCode. This is ONLY useful if you need to debug the language server ITSELF.
-
kotlin.languageServer.debugAttach.port:integerDefault:
5005[DEBUG] If transport is stdio this enables you to attach to the running language server with a debugger. This is ONLY useful if you need to debug the language server ITSELF.
-
kotlin.languageServer.enabled:booleanDefault:
true[Recommended] Specifies whether the language server should be used. When enabled the extension will provide code completions and linting, otherwise just syntax highlighting. Might require a reload to apply.
-
kotlin.languageServer.path:stringDefault:
""Optionally a custom path to the language server executable.
-
kotlin.languageServer.port:integerDefault:
0The port to which the client will attempt to connect to. A random port is used if zero. Only used if the transport layer is TCP.
-
kotlin.languageServer.transport:enum { "stdio", "tcp" }Default:
"stdio"The transport layer beneath the language server protocol. Note that the extension will launch the server even if a TCP socket is used.
-
kotlin.linting.debounceTime:integerDefault:
250[DEBUG] Specifies the debounce time limit. Lower to increase responsiveness at the cost of possible stability issues.
-
kotlin.snippetsEnabled:booleanDefault:
true[DEPRECATED] Specifies whether code completion should provide snippets (true) or plain-text items (false).
-
kotlin.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VSCode and the Kotlin language server.
Snippet to enable the language server:
require'lspconfig'.kotlin_language_server.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "kotlin-language-server" }
filetypes = { "kotlin" }
root_dir = root_pattern("settings.gradle")
lean3ls
https://github.com/leanprover/lean-client-js/tree/master/lean-language-server
Lean installation instructions can be found here.
Once Lean is installed, you can install the Lean 3 language server by running
npm install -g lean-language-server
Note: that if you're using lean.nvim,
that plugin fully handles the setup of the Lean language server,
and you shouldn't set up lean3ls both with it and lspconfig.
Snippet to enable the language server:
require'lspconfig'.lean3ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "lean-language-server", "--stdio", "--", "-M", "4096", "-T", "100000" }
filetypes = { "lean3" }
root_dir = root_pattern("leanpkg.toml") or root_pattern(".git") or path.dirname
single_file_support = true
leanls
https://github.com/leanprover/lean4
Lean installation instructions can be found here.
The Lean 4 language server is built-in with a Lean 4 install
(and can be manually run with, e.g., lean --server).
Note: that if you're using lean.nvim,
that plugin fully handles the setup of the Lean language server,
and you shouldn't set up leanls both with it and lspconfig.
Snippet to enable the language server:
require'lspconfig'.leanls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "lean", "--server" }
filetypes = { "lean" }
root_dir = root_pattern("lakefile.lean", "lean-toolchain", "leanpkg.toml", ".git")
single_file_support = true
lelwel_ls
https://github.com/0x2a-42/lelwel
Language server for lelwel grammars.
You can install lelwel-ls via cargo:
cargo install --features="lsp" lelwel
Snippet to enable the language server:
require'lspconfig'.lelwel_ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "lelwel-ls" }
filetypes = { "llw" }
root_dir = function(path)
-- Support git directories and git files (worktrees)
if M.path.is_dir(M.path.join(path, '.git')) or M.path.is_file(M.path.join(path, '.git')) then
return path
end
end)
end
lemminx
https://github.com/eclipse/lemminx
The easiest way to install the server is to get a binary at https://download.jboss.org/jbosstools/vscode/stable/lemminx-binary/ and place it in your PATH.
By default, lemminx doesn't have a cmd set. This is because nvim-lspconfig does not make assumptions about your path. You must add the following to your init.vim or init.lua to set cmd to the absolute path ($HOME and ~ are not expanded) of your unzipped lemminx.
require'lspconfig'.lemminx.setup{
cmd = { "/path/to/lemminx/lemminx" };
...
}
NOTE to macOS users: Binaries from unidentified developers are blocked by default. If you trust the downloaded binary from jboss.org, run it once, cancel the prompt, then remove the binary from Gatekeeper quarantine with xattr -d com.apple.quarantine lemminx. It should now run without being blocked.
Snippet to enable the language server:
require'lspconfig'.lemminx.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "xml", "xsd", "svg" }
root_dir = util.find_git_ancestor
single_file_support = true
ltex
https://github.com/valentjn/ltex-ls
LTeX Language Server: LSP language server for LanguageTool 🔍✔️ with support for LaTeX 🎓, Markdown 📝, and others
To install, download the latest release and ensure ltex-ls is on your path.
To support org files or R sweave, users can define a custom filetype autocommand (or use a plugin which defines these filetypes):
vim.cmd [[ autocmd BufRead,BufNewFile *.org set filetype=org ]]
This server accepts configuration via the settings key.
Available settings:
-
ltex.additionalRules.enablePickyRules:booleannull
-
ltex.additionalRules.languageModel:stringDefault:
""null
-
ltex.additionalRules.motherTongue:enum { "", "ar", "ast-ES", "be-BY", "br-FR", "ca-ES", "ca-ES-valencia", "da-DK", "de", "de-AT", "de-CH", "de-DE", "de-DE-x-simple-language", "el-GR", "en", "en-AU", "en-CA", "en-GB", "en-NZ", "en-US", "en-ZA", "eo", "es", "es-AR", "fa", "fr", "ga-IE", "gl-ES", "it", "ja-JP", "km-KH", "nl", "nl-BE", "pl-PL", "pt", "pt-AO", "pt-BR", "pt-MZ", "pt-PT", "ro-RO", "ru-RU", "sk-SK", "sl-SI", "sv", "ta-IN", "tl-PH", "uk-UA", "zh-CN" }Default:
""null
-
ltex.additionalRules.neuralNetworkModel:stringDefault:
""null
-
ltex.additionalRules.word2VecModel:stringDefault:
""null
-
ltex.bibtex.fields:objectDefault:
vim.empty_dict()null
-
ltex.checkFrequency:enum { "edit", "save", "manual" }Default:
"edit"null
-
ltex.clearDiagnosticsWhenClosingFile:booleanDefault:
truenull
-
ltex.completionEnabled:booleannull
-
ltex.configurationTarget:objectDefault:
{dictionary = "workspaceFolderExternalFile",disabledRules = "workspaceFolderExternalFile",hiddenFalsePositives = "workspaceFolderExternalFile"}null
-
ltex.diagnosticSeverityDefault:
"information"null
-
ltex.dictionary:objectDefault:
vim.empty_dict()null
-
ltex.disabledRules:objectDefault:
vim.empty_dict()null
-
ltex.enabledDefault:
{ "bibtex", "context", "context.tex", "html", "latex", "markdown", "org", "restructuredtext", "rsweave" }null
-
ltex.enabledRules:objectDefault:
vim.empty_dict()null
-
ltex.hiddenFalsePositives:objectDefault:
vim.empty_dict()null
-
ltex.java.initialHeapSize:integerDefault:
64null
-
ltex.java.maximumHeapSize:integerDefault:
512null
-
ltex.java.path:stringDefault:
""null
-
ltex.language:enum { "auto", "ar", "ast-ES", "be-BY", "br-FR", "ca-ES", "ca-ES-valencia", "da-DK", "de", "de-AT", "de-CH", "de-DE", "de-DE-x-simple-language", "el-GR", "en", "en-AU", "en-CA", "en-GB", "en-NZ", "en-US", "en-ZA", "eo", "es", "es-AR", "fa", "fr", "ga-IE", "gl-ES", "it", "ja-JP", "km-KH", "nl", "nl-BE", "pl-PL", "pt", "pt-AO", "pt-BR", "pt-MZ", "pt-PT", "ro-RO", "ru-RU", "sk-SK", "sl-SI", "sv", "ta-IN", "tl-PH", "uk-UA", "zh-CN" }Default:
"en-US"null
-
ltex.languageToolHttpServerUri:stringDefault:
""null
-
ltex.languageToolOrg.apiKey:stringDefault:
""null
-
ltex.languageToolOrg.username:stringDefault:
""null
-
ltex.latex.commands:objectDefault:
vim.empty_dict()null
-
ltex.latex.environments:objectDefault:
vim.empty_dict()null
-
ltex.ltex-ls.languageToolHttpServerUri:stringDefault:
""null
-
ltex.ltex-ls.languageToolOrgApiKey:stringDefault:
""null
-
ltex.ltex-ls.languageToolOrgUsername:stringDefault:
""null
-
ltex.ltex-ls.logLevel:enum { "severe", "warning", "info", "config", "fine", "finer", "finest" }Default:
"fine"null
-
ltex.ltex-ls.path:stringDefault:
""null
-
ltex.markdown.nodes:objectDefault:
vim.empty_dict()null
-
ltex.sentenceCacheSize:integerDefault:
2000null
-
ltex.statusBarItem:booleannull
-
ltex.trace.server:enum { "off", "messages", "verbose" }Default:
"off"null
Snippet to enable the language server:
require'lspconfig'.ltex.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ltex-ls" }
filetypes = { "bib", "markdown", "org", "plaintex", "rst", "rnoweb", "tex" }
get_language_id = function(_, filetype)
local language_id = language_id_mapping[filetype]
if language_id then
return language_id
else
return filetype
end
end,
root_dir = function(path)
-- Support git directories and git files (worktrees)
if M.path.is_dir(M.path.join(path, '.git')) or M.path.is_file(M.path.join(path, '.git')) then
return path
end
end)
end
metals
Scala language server with rich IDE features.
See full instructions in the Metals documentation:
https://scalameta.org/metals/docs/editors/vim.html#using-an-alternative-lsp-client
Note: that if you're using nvim-metals, that plugin fully handles the setup and installation of Metals, and you shouldn't set up Metals both with it and lspconfig.
To install Metals, make sure to have coursier installed, and once you do you can install the latest Metals with cs install metals. You can also manually bootstrap Metals with the following command.
cs bootstrap \
--java-opt -Xss4m \
--java-opt -Xms100m \
org.scalameta:metals_2.12:<enter-version-here> \
-r bintray:scalacenter/releases \
-r sonatype:snapshots \
-o /usr/local/bin/metals -f
Snippet to enable the language server:
require'lspconfig'.metals.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "metals" }
filetypes = { "scala" }
init_options = {
compilerOptions = {
snippetAutoIndent = false
},
isHttpEnabled = true,
statusBarProvider = "show-message"
}
message_level = 4
root_dir = util.root_pattern("build.sbt", "build.sc", "build.gradle", "pom.xml")
mint
Install Mint using the instructions. The language server is included since version 0.12.0.
Snippet to enable the language server:
require'lspconfig'.mint.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "mint", "ls" }
filetypes = { "mint" }
root_dir = function(fname)
return util.root_pattern 'mint.json'(fname) or util.find_git_ancestor(fname)
end,
single_file_support = true
nickel_ls
Nickel Language Server
https://github.com/tweag/nickel
nls can be installed with nix, or cargo, from the Nickel repository.
git clone https://github.com/tweag/nickel.git
Nix:
cd nickel
nix-env -f . -i
cargo:
cd nickel/lsp/nls
cargo install --path .
In order to have lspconfig detect Nickel filetypes (a prequisite for autostarting a server), install the Nickel vim plugin.
Snippet to enable the language server:
require'lspconfig'.nickel_ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "nls" }
filetypes = { "ncl", "nickel" }
root_dir = function(path)
-- Support git directories and git files (worktrees)
if M.path.is_dir(M.path.join(path, '.git')) or M.path.is_file(M.path.join(path, '.git')) then
return path
end
end)
end
nimls
https://github.com/PMunch/nimlsp
nimlsp can be installed via the nimble package manager:
nimble install nimlsp
This server accepts configuration via the settings key.
Available settings:
-
nim.buildCommand:stringDefault:
"c"Nim build command (c, cpp, doc, etc)
-
nim.buildOnSave:booleanExecute build task from tasks.json file on save.
-
nim.enableNimsuggest:booleanDefault:
trueEnable calling nimsuggest process to provide completion suggestions, hover suggestions, etc. This option requires restart to take effect.
-
nim.licenseString:stringDefault:
""Optional license text that will be inserted on nim file creation.
-
nim.lintOnSave:booleanDefault:
trueCheck code by using 'nim check' on save.
-
nim.logNimsuggest:booleanEnable verbose logging of nimsuggest to use profile directory.
-
nim.nimprettyIndent:integerDefault:
0Nimpretty: set the number of spaces that is used for indentation --indent:0 means autodetection (default behaviour).
-
nim.nimprettyMaxLineLen:integerDefault:
80Nimpretty: set the desired maximum line length (default: 80).
-
nim.nimsuggestRestartTimeout:integerDefault:
60Nimsuggest will be restarted after this timeout in minutes, if 0 then restart disabled. This option requires restart to take effect.
-
nim.project:arrayDefault:
{}Nim project file, if empty use current selected.
-
nim.projectMapping:objectDefault:
vim.empty_dict()For non project mode list of per file project mapping using regex, for example ```{"(.*).inim": "$1.nim"}```
-
nim.runOutputDirectory:stringDefault:
""Output directory for run selected file command. The directory is relative to the workspace root.
-
nim.test-project:stringDefault:
""Optional test project.
Snippet to enable the language server:
require'lspconfig'.nimls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "nimlsp" }
filetypes = { "nim" }
root_dir = function(fname)
return util.root_pattern '*.nimble'(fname) or util.find_git_ancestor(fname)
end,
single_file_support = true
ocamlls
https://github.com/ocaml-lsp/ocaml-language-server
ocaml-language-server can be installed via npm
npm install -g ocaml-language-server
Snippet to enable the language server:
require'lspconfig'.ocamlls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ocaml-language-server", "--stdio" }
filetypes = { "ocaml", "reason" }
root_dir = root_pattern("*.opam", "esy.json", "package.json")
ocamllsp
https://github.com/ocaml/ocaml-lsp
ocaml-lsp can be installed as described in installation guide.
To install the lsp server in a particular opam switch:
opam pin add ocaml-lsp-server https://github.com/ocaml/ocaml-lsp.git
opam install ocaml-lsp-server
Snippet to enable the language server:
require'lspconfig'.ocamllsp.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "ocamllsp" }
filetypes = { "ocaml", "ocaml.menhir", "ocaml.interface", "ocaml.ocamllex", "reason" }
get_language_id = function(_, ftype)
return language_id_of[ftype]
end
root_dir = root_pattern("*.opam", "esy.json", "package.json", ".git")
omnisharp
https://github.com/omnisharp/omnisharp-roslyn OmniSharp server based on Roslyn workspaces
omnisharp-roslyn can be installed by downloading and extracting a release from here.
Omnisharp can also be built from source by following the instructions here.
Omnisharp requires the dotnet-sdk to be installed.
By default, omnisharp-roslyn doesn't have a cmd set. This is because nvim-lspconfig does not make assumptions about your path. You must add the following to your init.vim or init.lua to set cmd to the absolute path ($HOME and ~ are not expanded) of the unzipped run script or binary.
local pid = vim.fn.getpid()
-- On linux/darwin if using a release build, otherwise under scripts/OmniSharp(.Core)(.cmd)
local omnisharp_bin = "/path/to/omnisharp-repo/run"
-- on Windows
-- local omnisharp_bin = "/path/to/omnisharp/OmniSharp.exe"
require'lspconfig'.omnisharp.setup{
cmd = { omnisharp_bin, "--languageserver" , "--hostPID", tostring(pid) };
...
}
Note, if you download the executable for darwin you will need to strip the quarantine label to run:
find /path/to/omnisharp-osx | xargs xattr -r -d com.apple.quarantine
Snippet to enable the language server:
require'lspconfig'.omnisharp.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "cs", "vb" }
init_options = {}
on_new_config = function(new_config, new_root_dir)
if new_root_dir then
table.insert(new_config.cmd, '-s')
table.insert(new_config.cmd, new_root_dir)
end
end,
root_dir = root_pattern(".sln") or root_pattern(".csproj")
pasls
https://github.com/genericptr/pascal-language-server
An LSP server implementation for Pascal variants that are supported by Free Pascal, including Object Pascal. It uses CodeTools from Lazarus as backend.
First set cmd to the Pascal lsp binary.
Customization options are passed to pasls as environment variables for example in your .bashrc:
export FPCDIR='/usr/lib/fpc/src' # FPC source directory (This is the only required option for the server to work).
export PP='/usr/lib/fpc/3.2.2/ppcx64' # Path to the Free Pascal compiler executable.
export LAZARUSDIR='/usr/lib/lazarus' # Path to the Lazarus sources.
export FPCTARGET='' # Target operating system for cross compiling.
export FPCTARGETCPU='x86_64' # Target CPU for cross compiling.
Snippet to enable the language server:
require'lspconfig'.pasls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "pasls" }
filetypes = { "pascal" }
root_dir = function(path)
-- Support git directories and git files (worktrees)
if M.path.is_dir(M.path.join(path, '.git')) or M.path.is_file(M.path.join(path, '.git')) then
return path
end
end)
end
single_file_support = true
perlls
https://github.com/richterger/Perl-LanguageServer/tree/master/clients/vscode/perl
Perl-LanguageServer, a language server for Perl.
To use the language server, ensure that you have Perl::LanguageServer installed and perl command is on your path.
This server accepts configuration via the settings key.
Available settings:
-
perl.cacheDir:stringDefault:
vim.NILdirectory for caching of parsed symbols, if the directory does not exists, it will be created, defaults to ${workspace}/.vscode/perl-lang. This should be one unqiue directory per project and an absolute path.
-
perl.debugAdapterPort:stringDefault:
"13603"port to use for connection between vscode and debug adapter inside Perl::LanguageServer. On a multi user system every user must use a different port.
-
perl.disableCache:booleanif true, the LanguageServer will not cache the result of parsing source files on disk, so it can be used within readonly directories
-
perl.enable:booleanDefault:
trueenable/disable this extension
-
perl.fileFilter:arrayDefault:
vim.NILarray for filtering perl file, defaults to *.pm|*.pl
-
perl.ignoreDirs:arrayDefault:
vim.NILdirectories to ignore, defaults to .vscode, .git, .svn
-
perl.logFile:stringDefault:
vim.NILIf set, log output is written to the given logfile, instead of displaying it in the vscode output pane. Log output is always appended so you are responsible for rotating the file.
-
perl.logLevel:integerDefault:
0Log level 0-2
-
perl.pathMap:arrayDefault:
vim.NILmapping of local to remote paths
-
perl.perlCmd:stringDefault:
vim.NILdefaults to perl
-
perl.perlInc:arrayDefault:
vim.NILarray with paths to add to perl library path. This setting is used by the syntax checker and for the debuggee and also for the LanguageServer itself. perl.perlInc should be absolute paths.
-
perl.showLocalVars:booleanif true, show also local variables in symbol view
-
perl.sshAddr:stringDefault:
vim.NILip address of remote system
-
perl.sshArgs:arrayDefault:
vim.NILoptional arguments for ssh
-
perl.sshCmd:stringDefault:
vim.NILdefaults to ssh on unix and plink on windows
-
perl.sshPort:stringDefault:
vim.NILoptional, port for ssh to remote system
-
perl.sshUser:stringDefault:
vim.NILuser for ssh login
-
perl.sshWorkspaceRoot:stringDefault:
vim.NILpath of the workspace root on remote system
Snippet to enable the language server:
require'lspconfig'.perlls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "perl", "-MPerl::LanguageServer", "-e", "Perl::LanguageServer::run", "--", "--port 13603", "--nostdio 0", "--version 2.1.0" }
filetypes = { "perl" }
root_dir = vim's starting directory
settings = {
perl = {
fileFilter = { ".pm", ".pl" },
ignoreDirs = ".git",
perlCmd = "perl",
perlInc = " "
}
}
single_file_support = true
perlpls
https://github.com/FractalBoy/perl-language-server https://metacpan.org/pod/PLS
PLS, another language server for Perl.
To use the language server, ensure that you have PLS installed and that it is in your path
This server accepts configuration via the settings key.
Available settings:
-
perl.cwd:stringDefault:
"."Current working directory to use
-
perl.inc:arrayDefault:
{}Paths to add to @INC.
-
perl.perlcritic.enabled:booleanDefault:
trueEnable perlcritic
-
perl.perlcritic.perlcriticrc:stringDefault:
"~/.perlcriticrc"Path to .perlcriticrc
-
perl.perltidyrc:stringDefault:
"~/.perltidyrc"Path to .perltidyrc
-
perl.pls:stringDefault:
"pls"Path to the pls executable script
-
perl.plsargs:arrayDefault:
{}Arguments to pass to the pls command
-
perl.syntax.enabled:booleanDefault:
trueEnable syntax checking
-
perl.syntax.perl:stringDefault:
""Path to the perl binary to use for syntax checking
Snippet to enable the language server:
require'lspconfig'.perlpls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "pls" }
filetypes = { "perl" }
root_dir = util.find_git_ancestor
settings = {
perl = {
perlcritic = {
enabled = false
}
}
}
single_file_support = true
phpactor
https://github.com/phpactor/phpactor
Installation: https://phpactor.readthedocs.io/en/master/usage/standalone.html#global-installation
Snippet to enable the language server:
require'lspconfig'.phpactor.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "phpactor", "language-server" }
filetypes = { "php" }
root_dir = root_pattern("composer.json", ".git")
powershell_es
https://github.com/PowerShell/PowerShellEditorServices
Language server for PowerShell.
To install, download and extract PowerShellEditorServices.zip
from the releases.
To configure the language server, set the property bundle_path to the root
of the extracted PowerShellEditorServices.zip.
The default configuration doesn't set cmd unless bundle_path is specified.
require'lspconfig'.powershell_es.setup{
bundle_path = 'c:/w/PowerShellEditorServices',
}
By default the languageserver is started in pwsh (PowerShell Core). This can be changed by specifying shell.
require'lspconfig'.powershell_es.setup{
bundle_path = 'c:/w/PowerShellEditorServices',
shell = 'powershell.exe',
}
Note that the execution policy needs to be set to Unrestricted for the languageserver run under PowerShell
If necessary, specific cmd can be defined instead of bundle_path.
See PowerShellEditorServices
to learn more.
require'lspconfig'.powershell_es.setup{
cmd = {'pwsh', '-NoLogo', '-NoProfile', '-Command', "c:/PSES/Start-EditorServices.ps1 ..."}
}
Snippet to enable the language server:
require'lspconfig'.powershell_es.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "ps1" }
on_new_config = function(new_config, _)
-- Don't overwrite cmd if already set
if not new_config.cmd then
new_config.cmd = make_cmd(new_config)
end
end,
root_dir = git root or current directory
shell = "pwsh"
single_file_support = true
prismals
npm install -g @prisma/language-server
'prismals, a language server for the prisma javascript and typescript orm'
Snippet to enable the language server:
require'lspconfig'.prismals.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "prisma-language-server", "--stdio" }
filetypes = { "prisma" }
root_dir = root_pattern(".git", "package.json")
settings = {
prisma = {
prismaFmtBinPath = ""
}
}
psalm
https://github.com/vimeo/psalm
Can be installed with composer.
composer global require vimeo/psalm
Snippet to enable the language server:
require'lspconfig'.psalm.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "psalm-language-server" }
filetypes = { "php" }
root_dir = root_pattern("psalm.xml", "psalm.xml.dist")
puppet
LSP server for Puppet.
Installation:
-
Clone the editor-services repository: https://github.com/puppetlabs/puppet-editor-services
-
Navigate into that directory and run:
bundle install -
Install the 'puppet-lint' gem:
gem install puppet-lint -
Add that repository to $PATH.
-
Ensure you can run
puppet-languageserverfrom outside the editor-services directory.
This server accepts configuration via the settings key.
Available settings:
-
puppet.editorService.debugFilePath:stringDefault:
""The absolute filepath where the Puppet Editor Service will output the debugging log. By default no logfile is generated
-
puppet.editorService.enable:booleanDefault:
trueEnable/disable advanced Puppet Language Features
-
puppet.editorService.featureFlags:arrayDefault:
{}An array of strings of experimental features to enable in the Puppet Editor Service
-
puppet.editorService.foldingRange.enable:booleanDefault:
trueEnable/disable syntax aware code folding provider
-
puppet.editorService.foldingRange.showLastLine:booleanShow or hide the last line in code folding regions
-
puppet.editorService.formatOnType.enable:booleanEnable/disable the Puppet document on-type formatter, for example hashrocket alignment
-
puppet.editorService.formatOnType.maxFileSize:integerDefault:
4096Sets the maximum file size (in Bytes) that document on-type formatting will occur. Setting this to zero (0) will disable the file size check. Note that large file sizes can cause performance issues.
-
puppet.editorService.hover.showMetadataInfo:booleanDefault:
trueEnable or disable showing Puppet Module version information in the metadata.json file
-
puppet.editorService.loglevel:enum { "debug", "error", "normal", "warning", "verbose" }Default:
"normal"Set the logging verbosity level for the Puppet Editor Service, with Debug producing the most output and Error producing the least
-
puppet.editorService.protocol:enum { "stdio", "tcp" }Default:
"stdio"The protocol used to communicate with the Puppet Editor Service. By default the local STDIO protocol is used.
-
puppet.editorService.puppet.confdir:stringDefault:
""The Puppet configuration directory. See https://puppet.com/docs/puppet/latest/dirs_confdir.html for more information
-
puppet.editorService.puppet.environment:stringDefault:
""The Puppet environment to use. See https://puppet.com/docs/puppet/latest/config_print.html#environments for more information
-
puppet.editorService.puppet.modulePath:stringDefault:
""Additional module paths to use when starting the Editor Services. On Windows this is delimited with a semicolon, and on all other platforms, with a colon. For example C:\Path1;C:\Path2
-
puppet.editorService.puppet.vardir:stringDefault:
""The Puppet cache directory. See https://puppet.com/docs/puppet/latest/dirs_vardir.html for more information
-
puppet.editorService.puppet.version:stringDefault:
""The version of Puppet to use. For example '5.4.0'. This is generally only applicable when using the PDK installation type. If Puppet Editor Services is unable to use this version, it will default to the latest available version of Puppet.
-
puppet.editorService.tcp.address:stringThe IP address or hostname of the remote Puppet Editor Service to connect to, for example 'computer.domain' or '192.168.0.1'. Only applicable when the editorService.protocol is set to tcp
-
puppet.editorService.tcp.port:integerThe TCP Port of the remote Puppet Editor Service to connect to. Only applicable when the editorService.protocol is set to tcp
-
puppet.editorService.timeout:integerDefault:
10The timeout to connect to the Puppet Editor Service
-
puppet.format.enable:booleanDefault:
trueEnable/disable the Puppet document formatter
-
puppet.installDirectory:stringnull
-
puppet.installType:enum { "auto", "pdk", "agent" }Default:
"auto"null
-
puppet.notification.nodeGraph:enum { "messagebox", "statusbar", "none" }Default:
"messagebox"The type of notification used when a node graph is being generated. Default value of messagebox
-
puppet.notification.puppetResource:enum { "messagebox", "statusbar", "none" }Default:
"messagebox"The type of notification used when a running Puppet Resouce. Default value of messagebox
-
puppet.pdk.checkVersion:booleanDefault:
trueEnable/disable checking if installed PDK version is latest
-
puppet.titleBar.pdkNewModule.enable:booleanDefault:
trueEnable/disable the PDK New Module icon in the Editor Title Bar
-
puppet.validate.resolvePuppetfiles:booleanDefault:
trueEnable/disable using dependency resolution for Puppetfiles
Snippet to enable the language server:
require'lspconfig'.puppet.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "puppet-languageserver", "--stdio" }
filetypes = { "puppet" }
root_dir = root_pattern("manifests", ".puppet-lint.rc", "hiera.yaml", ".git")
single_file_support = true
purescriptls
https://github.com/nwolverson/purescript-language-server
purescript-language-server can be installed via npm
npm install -g purescript-language-server
This server accepts configuration via the settings key.
Available settings:
-
purescript.addNpmPath:booleanWhether to add the local npm bin directory to the PATH for purs IDE server and build command.
-
purescript.addPscPackageSources:booleanWhether to add psc-package sources to the globs passed to the IDE server for source locations (specifically the output of `psc-package sources`, if this is a psc-package project). Update due to adding packages/changing package set requires psc-ide server restart.
-
purescript.addSpagoSources:booleanDefault:
trueWhether to add spago sources to the globs passed to the IDE server for source locations (specifically the output of `spago sources`, if this is a spago project). Update due to adding packages/changing package set requires psc-ide server restart.
-
purescript.autoStartPscIde:booleanDefault:
trueWhether to automatically start/connect to purs IDE server when editing a PureScript file (includes connecting to an existing running instance). If this is disabled, various features like autocomplete, tooltips, and other type info will not work until start command is run manually.
-
purescript.autocompleteAddImport:booleanDefault:
trueWhether to automatically add imported identifiers when accepting autocomplete result.
-
purescript.autocompleteAllModules:booleanDefault:
trueWhether to always autocomplete from all built modules, or just those imported in the file. Suggestions from all modules always available by explicitly triggering autocomplete.
-
purescript.autocompleteGrouped:booleanDefault:
trueWhether to group completions in autocomplete results. Requires compiler 0.11.6
-
purescript.autocompleteLimit:null|integerDefault:
vim.NILMaximum number of results to fetch for an autocompletion request. May improve performance on large projects.
-
purescript.buildCommand:stringDefault:
"spago build --purs-args --json-errors"Build command to use with arguments. Not passed to shell. eg `spago build --purs-args --json-errors`
-
purescript.buildOpenedFiles:booleannull
-
purescript.censorWarnings:arrayDefault:
{}Array items:
{type = "string"}The warning codes to censor, both for fast rebuild and a full build. Unrelated to any psa setup. e.g.: ["ShadowedName","MissingTypeDeclaration"]
-
purescript.codegenTargets:arrayDefault:
vim.NILArray items:
{type = "string"}List of codegen targets to pass to the compiler for rebuild. e.g. js, corefn. If not specified (rather than empty array) this will not be passed and the compiler will default to js. Requires 0.12.1+
-
purescript.fastRebuild:booleanDefault:
trueEnable purs IDE server fast rebuild
-
purescript.formatter:enum { "none", "purty", "purs-tidy", "pose" }Default:
"purty"Tool to use to for formatting. Must be installed and on PATH (or npm installed with addNpmPath set)
-
purescript.fullBuildOnSave:booleanWhether to perform a full build on save with the configured build command (rather than IDE server fast rebuild). This is not generally recommended because it is slow, but it does mean that dependent modules are rebuilt as necessary.
-
purescript.importsPreferredModules:arrayDefault:
{ "Prelude" }Array items:
{type = "string"}Module to prefer to insert when adding imports which have been re-exported. In order of preference, most preferred first.
-
purescript.outputDirectory:stringDefault:
"output/"Override purs ide output directory (output/ if not specified). This should match up to your build command
-
purescript.packagePath:stringDefault:
""Path to installed packages. Will be used to control globs passed to IDE server for source locations. Change requires IDE server restart.
-
purescript.preludeModule:stringDefault:
"Prelude"Module to consider as your default prelude, if an auto-complete suggestion comes from this module it will be imported unqualified.
-
purescript.pscIdePort:integer|nullDefault:
vim.NILPort to use for purs IDE server (whether an existing server or to start a new one). By default a random port is chosen (or an existing port in .psc-ide-port if present), if this is specified no attempt will be made to select an alternative port on failure.
-
purescript.pscIdelogLevel:stringDefault:
""Log level for purs IDE server
-
purescript.pursExe:stringDefault:
"purs"Location of purs executable (resolved wrt PATH)
-
purescript.sourcePath:stringDefault:
"src"Path to application source root. Will be used to control globs passed to IDE server for source locations. Change requires IDE server restart.
-
purescript.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VSCode and the PureScript language service.
Snippet to enable the language server:
require'lspconfig'.purescriptls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "purescript-language-server", "--stdio" }
filetypes = { "purescript" }
root_dir = root_pattern("spago.dhall, 'psc-package.json', bower.json")
pylsp
https://github.com/python-lsp/python-lsp-server
A Python 3.6+ implementation of the Language Server Protocol.
The language server can be installed via pipx install 'python-lsp-server[all]'.
Further instructions can be found in the project's README.
Note: This is a community fork of pyls.
Snippet to enable the language server:
require'lspconfig'.pylsp.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "pylsp" }
filetypes = { "python" }
root_dir = function(fname)
local root_files = {
'pyproject.toml',
'setup.py',
'setup.cfg',
'requirements.txt',
'Pipfile',
}
return util.root_pattern(unpack(root_files))(fname) or util.find_git_ancestor(fname)
end,
single_file_support = true
pyre
pyre a static type checker for Python 3.
pyre offers an extremely limited featureset. It currently only supports diagnostics,
which are triggered on save.
Do not report issues for missing features in pyre to lspconfig.
Snippet to enable the language server:
require'lspconfig'.pyre.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "pyre", "persistent" }
filetypes = { "python" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
pyright
https://github.com/microsoft/pyright
pyright, a static type checker and language server for python
This server accepts configuration via the settings key.
Available settings:
-
pyright.disableLanguageServices:booleanDisables type completion, definitions, and references.
-
pyright.disableOrganizeImports:booleanDisables the “Organize Imports” command.
-
python.analysis.autoImportCompletions:booleanDefault:
trueOffer auto-import completions.
-
python.analysis.autoSearchPaths:booleanDefault:
trueAutomatically add common search paths like 'src'?
-
python.analysis.diagnosticMode:enum { "openFilesOnly", "workspace" }Default:
"openFilesOnly"null
-
python.analysis.diagnosticSeverityOverrides:objectDefault:
vim.empty_dict()Allows a user to override the severity levels for individual diagnostics.
-
python.analysis.extraPaths:arrayDefault:
{}Array items:
{type = "string"}Additional import search resolution paths
-
python.analysis.logLevel:enum { "Error", "Warning", "Information", "Trace" }Default:
"Information"Specifies the level of logging for the Output panel
-
python.analysis.stubPath:stringDefault:
"typings"Path to directory containing custom type stub files.
-
python.analysis.typeCheckingMode:enum { "off", "basic", "strict" }Default:
"basic"Defines the default rule set for type checking.
-
python.analysis.typeshedPaths:arrayDefault:
{}Array items:
{type = "string"}Paths to look for typeshed modules.
-
python.analysis.useLibraryCodeForTypes:booleanUse library implementations to extract type information when type stub is not present.
-
python.pythonPath:stringDefault:
"python"Path to Python, you can use a custom version of Python.
-
python.venvPath:stringDefault:
""Path to folder with a list of Virtual Environments.
Snippet to enable the language server:
require'lspconfig'.pyright.setup{}
Commands and default values:
Commands:
- PyrightOrganizeImports: Organize Imports
Default Values:
cmd = { "pyright-langserver", "--stdio" }
filetypes = { "python" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {
python = {
analysis = {
autoSearchPaths = true,
diagnosticMode = "workspace",
useLibraryCodeForTypes = true
}
}
}
single_file_support = true
r_language_server
languageserver is an implementation of the Microsoft's Language Server Protocol for the R language.
It is released on CRAN and can be easily installed by
install.packages("languageserver")
This server accepts configuration via the settings key.
Available settings:
-
r.lsp.args:arrayDefault:
{}The command line arguments to use when launching R Language Server
-
r.lsp.debug:booleanDebug R Language Server
-
r.lsp.diagnostics:booleanDefault:
trueEnable Diagnostics
-
r.lsp.lang:stringDefault:
""Override default LANG environment variable
-
r.lsp.path:stringDefault:
""Path to R binary for launching Language Server
-
r.lsp.use_stdio:booleanUse STDIO connection instead of TCP. (Unix/macOS users only)
-
r.rpath.linux:stringDefault:
""Path to an R executable for Linux. Must be "vanilla" R, not radian etc.!
-
r.rpath.mac:stringDefault:
""Path to an R executable for macOS. Must be "vanilla" R, not radian etc.!
-
r.rpath.windows:stringDefault:
""Path to an R executable for Windows. Must be "vanilla" R, not radian etc.!
Snippet to enable the language server:
require'lspconfig'.r_language_server.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "R", "--slave", "-e", "languageserver::run()" }
filetypes = { "r", "rmd" }
log_level = 2
root_dir = root_pattern(".git") or os_homedir
racket_langserver
https://github.com/jeapostrophe/racket-langserver
The Racket language server. This project seeks to use DrRacket's public API to provide functionality that mimics DrRacket's code tools as closely as possible.
Install via raco: raco pkg install racket-langserver
Snippet to enable the language server:
require'lspconfig'.racket_langserver.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "racket", "--lib", "racket-langserver" }
filetypes = { "racket", "scheme" }
root_dir = function(path)
-- Support git directories and git files (worktrees)
if M.path.is_dir(M.path.join(path, '.git')) or M.path.is_file(M.path.join(path, '.git')) then
return path
end
end)
end
single_file_support = true
rescriptls
https://github.com/rescript-lang/rescript-vscode
ReScript language server
By default, rescriptls doesn't have a cmd set. This is because nvim-lspconfig does not make assumptions about your path.
You have to install the language server manually.
You can use the bundled language server inside the vim-rescript repo.
Clone the vim-rescript repo and point cmd to server.js inside server/out directory:
cmd = {'node', '<path_to_repo>/server/out/server.js', '--stdio'}
If you have vim-rescript installed you can also use that installation. for example if you're using packer.nvim you can set cmd to something like this:
cmd = {
'node',
'/home/username/.local/share/nvim/site/pack/packer/start/vim-rescript/server/out/server.js',
'--stdio'
}
Another option is to use vscode extension release. Take a look at here for instructions.
Snippet to enable the language server:
require'lspconfig'.rescriptls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = {}
filetypes = { "rescript" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {}
rls
https://github.com/rust-lang/rls
rls, a language server for Rust
See https://github.com/rust-lang/rls#setup to setup rls itself. See https://github.com/rust-lang/rls#configuration for rls-specific settings. All settings listed on the rls configuration section of the readme must be set under settings.rust as follows:
nvim_lsp.rls.setup {
settings = {
rust = {
unstable_features = true,
build_on_save = false,
all_features = true,
},
},
}
If you want to use rls for a particular build, eg nightly, set cmd as follows:
cmd = {"rustup", "run", "nightly", "rls"}
Snippet to enable the language server:
require'lspconfig'.rls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "rls" }
filetypes = { "rust" }
root_dir = root_pattern("Cargo.toml")
rnix
https://github.com/nix-community/rnix-lsp
A language server for Nix providing basic completion and formatting via nixpkgs-fmt.
To install manually, run cargo install rnix-lsp. If you are using nix, rnix-lsp is in nixpkgs.
This server accepts configuration via the settings key.
Snippet to enable the language server:
require'lspconfig'.rnix.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "rnix-lsp" }
filetypes = { "nix" }
init_options = {}
root_dir = vim's starting directory
settings = {}
robotframework_ls
https://github.com/robocorp/robotframework-lsp
Language Server Protocol implementation for Robot Framework.
Snippet to enable the language server:
require'lspconfig'.robotframework_ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "robotframework_ls" }
filetypes = { "robot" }
root_dir = util.root_pattern('robotidy.toml', 'pyproject.toml')(fname) or util.find_git_ancestor(fname)
rome
Language server for the Rome Frontend Toolchain.
npm install [-g] rome
Snippet to enable the language server:
require'lspconfig'.rome.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "rome", "lsp" }
filetypes = { "javascript", "javascriptreact", "json", "typescript", "typescript.tsx", "typescriptreact" }
root_dir = root_pattern('package.json', 'node_modules', '.git') or dirname
single_file_support = true
rust_analyzer
https://github.com/rust-analyzer/rust-analyzer
rust-analyzer (aka rls 2.0), a language server for Rust
See docs for extra settings.
This server accepts configuration via the settings key.
Available settings:
-
$generated-endnull
-
$generated-startnull
-
rust-analyzer.assist.allowMergingIntoGlobImports:booleanDefault:
truenull
-
rust-analyzer.assist.importEnforceGranularity:booleannull
-
rust-analyzer.assist.importGranularity:enum { "preserve", "crate", "module", "item" }Default:
"crate"null
-
rust-analyzer.assist.importGroup:booleanDefault:
truenull
-
rust-analyzer.assist.importPrefix:enum { "plain", "self", "crate" }Default:
"plain"null
-
rust-analyzer.cache.warmup:booleanDefault:
truenull
-
rust-analyzer.callInfo.full:booleanDefault:
truenull
-
rust-analyzer.cargo.allFeatures:booleannull
-
rust-analyzer.cargo.autoreload:booleanDefault:
truenull
-
rust-analyzer.cargo.features:arrayDefault:
{}Array items:
{type = "string"}null
-
rust-analyzer.cargo.noDefaultFeatures:booleannull
-
rust-analyzer.cargo.noSysroot:booleannull
-
rust-analyzer.cargo.runBuildScripts:booleanDefault:
truenull
-
rust-analyzer.cargo.target:null|stringDefault:
vim.NILnull
-
rust-analyzer.cargo.unsetTest:arrayDefault:
{ "core" }Array items:
{type = "string"}null
-
rust-analyzer.cargo.useRustcWrapperForBuildScripts:booleanDefault:
truenull
-
rust-analyzer.cargoRunner:null|stringDefault:
vim.NILCustom cargo runner extension ID.
-
rust-analyzer.checkOnSave.allFeatures:null|booleanDefault:
vim.NILnull
-
rust-analyzer.checkOnSave.allTargets:booleanDefault:
truenull
-
rust-analyzer.checkOnSave.command:stringDefault:
"check"null
-
rust-analyzer.checkOnSave.enable:booleanDefault:
truenull
-
rust-analyzer.checkOnSave.extraArgs:arrayDefault:
{}Array items:
{type = "string"}null
-
rust-analyzer.checkOnSave.features:null|arrayDefault:
vim.NILArray items:
{type = "string"}null
-
rust-analyzer.checkOnSave.noDefaultFeatures:null|booleanDefault:
vim.NILnull
-
rust-analyzer.checkOnSave.overrideCommand:null|arrayDefault:
vim.NILArray items:
{type = "string"}null
-
rust-analyzer.checkOnSave.target:null|stringDefault:
vim.NILnull
-
rust-analyzer.completion.addCallArgumentSnippets:booleanDefault:
truenull
-
rust-analyzer.completion.addCallParenthesis:booleanDefault:
truenull
-
rust-analyzer.completion.autoimport.enable:booleanDefault:
truenull
-
rust-analyzer.completion.autoself.enable:booleanDefault:
truenull
-
rust-analyzer.completion.postfix.enable:booleanDefault:
truenull
-
rust-analyzer.completion.snippets:objectDefault:
vim.empty_dict()null
-
rust-analyzer.debug.engine:enum { "auto", "vadimcn.vscode-lldb", "ms-vscode.cpptools" }Default:
"auto"Preferred debug engine.
-
rust-analyzer.debug.engineSettings:objectDefault:
vim.empty_dict()null
-
rust-analyzer.debug.openDebugPane:booleannull
-
rust-analyzer.debug.sourceFileMap:object|stringDefault:
{["/rustc/<id>"] = "${env:USERPROFILE}/.rustup/toolchains/<toolchain-id>/lib/rustlib/src/rust"}Optional source file mappings passed to the debug engine.
-
rust-analyzer.diagnostics.disabled:arrayDefault:
{}Array items:
{type = "string"}null
-
rust-analyzer.diagnostics.enable:booleanDefault:
truenull
-
rust-analyzer.diagnostics.enableExperimental:booleanDefault:
truenull
-
rust-analyzer.diagnostics.remapPrefix:objectDefault:
vim.empty_dict()null
-
rust-analyzer.diagnostics.warningsAsHint:arrayDefault:
{}Array items:
{type = "string"}null
-
rust-analyzer.diagnostics.warningsAsInfo:arrayDefault:
{}Array items:
{type = "string"}null
-
rust-analyzer.experimental.procAttrMacros:booleanDefault:
truenull
-
rust-analyzer.files.excludeDirs:arrayDefault:
{}Array items:
{type = "string"}null
-
rust-analyzer.files.watcher:stringDefault:
"client"null
-
rust-analyzer.highlightRelated.breakPoints:booleanDefault:
truenull
-
rust-analyzer.highlightRelated.exitPoints:booleanDefault:
truenull
-
rust-analyzer.highlightRelated.references:booleanDefault:
truenull
-
rust-analyzer.highlightRelated.yieldPoints:booleanDefault:
truenull
-
rust-analyzer.highlighting.strings:booleanDefault:
truenull
-
rust-analyzer.hover.documentation:booleanDefault:
truenull
-
rust-analyzer.hover.linksInHover:booleanDefault:
truenull
-
rust-analyzer.hoverActions.debug:booleanDefault:
truenull
-
rust-analyzer.hoverActions.enable:booleanDefault:
truenull
-
rust-analyzer.hoverActions.gotoTypeDef:booleanDefault:
truenull
-
rust-analyzer.hoverActions.implementations:booleanDefault:
truenull
-
rust-analyzer.hoverActions.references:booleannull
-
rust-analyzer.hoverActions.run:booleanDefault:
truenull
-
rust-analyzer.inlayHints.chainingHints:booleanDefault:
truenull
-
rust-analyzer.inlayHints.enable:booleanDefault:
trueWhether to show inlay hints.
-
rust-analyzer.inlayHints.hideNamedConstructorHints:booleannull
-
rust-analyzer.inlayHints.maxLength:null|integerDefault:
25null
-
rust-analyzer.inlayHints.parameterHints:booleanDefault:
truenull
-
rust-analyzer.inlayHints.smallerHints:booleanDefault:
trueWhether inlay hints font size should be smaller than editor's font size.
-
rust-analyzer.inlayHints.typeHints:booleanDefault:
truenull
-
rust-analyzer.joinLines.joinAssignments:booleanDefault:
truenull
-
rust-analyzer.joinLines.joinElseIf:booleanDefault:
truenull
-
rust-analyzer.joinLines.removeTrailingComma:booleanDefault:
truenull
-
rust-analyzer.joinLines.unwrapTrivialBlock:booleanDefault:
truenull
-
rust-analyzer.lens.debug:booleanDefault:
truenull
-
rust-analyzer.lens.enable:booleanDefault:
truenull
-
rust-analyzer.lens.enumVariantReferences:booleannull
-
rust-analyzer.lens.forceCustomCommands:booleanDefault:
truenull
-
rust-analyzer.lens.implementations:booleanDefault:
truenull
-
rust-analyzer.lens.methodReferences:booleannull
-
rust-analyzer.lens.references:booleannull
-
rust-analyzer.lens.run:booleanDefault:
truenull
-
rust-analyzer.linkedProjects:arrayDefault:
{}Array items:
{type = { "string", "object" }}null
-
rust-analyzer.lruCapacity:null|integerDefault:
vim.NILnull
-
rust-analyzer.notifications.cargoTomlNotFound:booleanDefault:
truenull
-
rust-analyzer.procMacro.enable:booleanDefault:
truenull
-
rust-analyzer.procMacro.server:null|stringDefault:
vim.NILnull
-
rust-analyzer.runnableEnvDefault:
vim.NILnull
-
rust-analyzer.runnables.cargoExtraArgs:arrayDefault:
{}Array items:
{type = "string"}null
-
rust-analyzer.runnables.overrideCargo:null|stringDefault:
vim.NILnull
-
rust-analyzer.rustcSource:null|stringDefault:
vim.NILnull
-
rust-analyzer.rustfmt.enableRangeFormatting:booleannull
-
rust-analyzer.rustfmt.extraArgs:arrayDefault:
{}Array items:
{type = "string"}null
-
rust-analyzer.rustfmt.overrideCommand:null|arrayDefault:
vim.NILArray items:
{type = "string"}null
-
rust-analyzer.server.extraEnv:null|objectDefault:
vim.NILnull
-
rust-analyzer.server.path:null|stringDefault:
vim.NILnull
-
rust-analyzer.trace.extension:booleanEnable logging of VS Code extensions itself.
-
rust-analyzer.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Trace requests to the rust-analyzer (this is usually overly verbose and not recommended for regular users).
-
rust-analyzer.updates.askBeforeDownload:booleanWhether to ask for permission before downloading any files from the Internet.
-
rust-analyzer.updates.channel:enum { "stable", "nightly" }Default:
"stable"null
-
rust-analyzer.workspace.symbol.search.kind:enum { "only_types", "all_symbols" }Default:
"only_types"null
-
rust-analyzer.workspace.symbol.search.scope:enum { "workspace", "workspace_and_dependencies" }Default:
"workspace"null
Snippet to enable the language server:
require'lspconfig'.rust_analyzer.setup{}
Commands and default values:
Commands:
- CargoReload: Reload current cargo workspace
Default Values:
cmd = { "rust-analyzer" }
filetypes = { "rust" }
root_dir = root_pattern("Cargo.toml", "rust-project.json")
settings = {
["rust-analyzer"] = {}
}
scry
https://github.com/crystal-lang-tools/scry
Crystal language server.
Snippet to enable the language server:
require'lspconfig'.scry.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "scry" }
filetypes = { "crystal" }
root_dir = root_pattern('shard.yml', '.git') or dirname
single_file_support = true
serve_d
https://github.com/Pure-D/serve-d
`Microsoft language server protocol implementation for D using workspace-d.`
Download a binary from https://github.com/Pure-D/serve-d/releases and put it in your $PATH.
Snippet to enable the language server:
require'lspconfig'.serve_d.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "serve-d" }
filetypes = { "d" }
root_dir = util.root_pattern("dub.json", "dub.sdl", ".git")
sixtyfps
https://github.com/sixtyfpsui/sixtyfps
SixtyFPS's language server
You can build and install sixtyfps-lsp binary with cargo:
cargo install sixtyfps-lsp
Vim does not have built-in syntax for the sixtyfps filetype currently.
This can be added via an autocmd:
vim.cmd [[ autocmd BufRead,BufNewFile *.60 set filetype=sixtyfps ]]
or by installing a filetype plugin such as https://github.com/RustemB/sixtyfps-vim
Snippet to enable the language server:
require'lspconfig'.sixtyfps.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "sixtyfps-lsp" }
filetypes = { "sixtyfps" }
single_file_support = true
solang
A language server for Solidity
See the documentation for installation instructions.
The language server only provides the following capabilities:
- Syntax highlighting
- Diagnostics
- Hover
There is currently no support for completion, goto definition, references, or other functionality.
Snippet to enable the language server:
require'lspconfig'.solang.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "solang", "--language-server", "--target", "ewasm" }
filetypes = { "solidity" }
root_dir = util.find_git_ancestor
solargraph
solargraph, a language server for Ruby
You can install solargraph via gem install.
gem install --user-install solargraph
This server accepts configuration via the settings key.
Available settings:
-
solargraph.autoformat:enum { true, false }Enable automatic formatting while typing (WARNING: experimental)
-
solargraph.bundlerPath:stringDefault:
"bundle"Path to the bundle executable, defaults to 'bundle'. Needs to be an absolute path for the 'bundle' exec/shim
-
solargraph.checkGemVersion:enum { true, false }Default:
trueAutomatically check if a new version of the Solargraph gem is available.
-
solargraph.commandPath:stringDefault:
"solargraph"Path to the solargraph command. Set this to an absolute path to select from multiple installed Ruby versions.
-
solargraph.completion:enum { true, false }Default:
trueEnable completion
-
solargraph.definitions:enum { true, false }Default:
trueEnable definitions (go to, etc.)
-
solargraph.diagnostics:enum { true, false }Enable diagnostics
-
solargraph.externalServer:objectDefault:
{host = "localhost",port = 7658}The host and port to use for external transports. (Ignored for stdio and socket transports.)
-
solargraph.folding:booleanDefault:
trueEnable folding ranges
-
solargraph.formatting:enum { true, false }Enable document formatting
-
solargraph.hover:enum { true, false }Default:
trueEnable hover
-
solargraph.logLevel:enum { "warn", "info", "debug" }Default:
"warn"Level of debug info to log. `warn` is least and `debug` is most.
-
solargraph.references:enum { true, false }Default:
trueEnable finding references
-
solargraph.rename:enum { true, false }Default:
trueEnable symbol renaming
-
solargraph.symbols:enum { true, false }Default:
trueEnable symbols
-
solargraph.transport:enum { "socket", "stdio", "external" }Default:
"socket"The type of transport to use.
-
solargraph.useBundler:booleanUse `bundle exec` to run solargraph. (If this is true, the solargraph.commandPath setting is ignored.)
Snippet to enable the language server:
require'lspconfig'.solargraph.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "solargraph", "stdio" }
filetypes = { "ruby" }
init_options = {
formatting = true
}
root_dir = root_pattern("Gemfile", ".git")
settings = {
solargraph = {
diagnostics = true
}
}
sorbet
Sorbet is a fast, powerful type checker designed for Ruby.
You can install Sorbet via gem install. You might also be interested in how to set Sorbet up for new projects: https://sorbet.org/docs/adopting.
gem install sorbet
Snippet to enable the language server:
require'lspconfig'.sorbet.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "srb", "tc", "--lsp" }
filetypes = { "ruby" }
root_dir = root_pattern("Gemfile", ".git")
sourcekit
https://github.com/apple/sourcekit-lsp
Language server for Swift and C/C++/Objective-C.
This server accepts configuration via the settings key.
Available settings:
-
sourcekit-lsp.inlayHints.enabled:boolean(experimental) Render inlay type annotations in the editor.
-
sourcekit-lsp.serverArguments:arrayDefault:
{}Array items:
{type = "string"}Arguments to pass to sourcekit-lsp. Argument keys and values should be provided as separate entries in the array e.g. ['--log-level', 'debug']
-
sourcekit-lsp.serverPath:stringDefault:
"sourcekit-lsp"The path of the sourcekit-lsp executable
-
sourcekit-lsp.toolchainPath:stringDefault:
""(optional) The path of the swift toolchain. By default, sourcekit-lsp uses the toolchain it is installed in.
-
sourcekit-lsp.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VS Code and the SourceKit-LSP language server.
Snippet to enable the language server:
require'lspconfig'.sourcekit.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "sourcekit-lsp" }
filetypes = { "swift", "c", "cpp", "objective-c", "objective-cpp" }
root_dir = root_pattern("Package.swift", ".git")
spectral
https://github.com/luizcorreia/spectral-language-server
A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI v2 & v3.
spectral-language-server can be installed via npm:
npm i -g spectral-language-server
See vscode-spectral for configuration options.
This server accepts configuration via the settings key.
Available settings:
-
spectral.enable:booleanDefault:
trueControls whether or not Spectral is enabled.
-
spectral.rulesetFile:stringLocation of the ruleset file to use when validating. If omitted, the default is a .spectral.yml/.spectral.json in the same folder as the document being validated. Paths are relative to the workspace.
-
spectral.run:enum { "onSave", "onType" }Default:
"onType"Run the linter on save (onSave) or as you type (onType).
-
spectral.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VS Code and the language server.
-
spectral.validateFiles:arrayArray items:
{type = "string"}An array of file globs (e.g., `**/*.yaml`) in minimatch glob format which should be validated by Spectral. If language identifiers are also specified, the file must match both in order to be validated.
-
spectral.validateLanguages:arrayDefault:
{ "json", "yaml" }Array items:
{type = "string"}An array of language IDs which should be validated by Spectral. If file globs are also specified, the file must match both in order to be validated.
Snippet to enable the language server:
require'lspconfig'.spectral.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "spectral-language-server", "--stdio" }
filetypes = { "yaml", "json", "yml" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {
enable = true,
run = "onType",
validateLanguages = { "yaml", "json", "yml" }
}
single_file_support = true
sqlls
https://github.com/joe-re/sql-language-server
cmd value is not set by default. The cmd value can be overridden in the setup table;
require'lspconfig'.sqlls.setup{
cmd = {"path/to/command", "up", "--method", "stdio"};
...
}
This LSP can be installed via npm. Find further instructions on manual installation of the sql-language-server at joe-re/sql-language-server.
Snippet to enable the language server:
require'lspconfig'.sqlls.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "sql", "mysql" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {}
sqls
https://github.com/lighttiger2505/sqls
require'lspconfig'.sqls.setup{
cmd = {"path/to/command", "-config", "path/to/config.yml"};
...
}
Sqls can be installed via go get github.com/lighttiger2505/sqls. Instructions for compiling Sqls from the source can be found at lighttiger2505/sqls.
Snippet to enable the language server:
require'lspconfig'.sqls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "sqls" }
filetypes = { "sql", "mysql" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {}
single_file_support = true
stylelint_lsp
https://github.com/bmatcuk/stylelint-lsp
stylelint-lsp can be installed via npm:
npm i -g stylelint-lsp
Can be configured by passing a settings.stylelintplus object to stylelint_lsp.setup:
require'lspconfig'.stylelint_lsp.setup{
settings = {
stylelintplus = {
-- see available options in stylelint-lsp documentation
}
}
}
This server accepts configuration via the settings key.
Available settings:
-
stylelintplus.autoFixOnFormat:booleanAuto-fix on format request.
-
stylelintplus.autoFixOnSave:booleanAuto-fix and format on save.
-
stylelintplus.config:objectDefault:
vim.NILStylelint config. If config and configFile are unset, stylelint will automatically look for a config file.
-
stylelintplus.configFile:stringDefault:
vim.NILStylelint config file. If config and configFile are unset, stylelint will automatically look for a config file.
-
stylelintplus.configOverrides:objectDefault:
vim.NILStylelint config overrides. These will be applied on top of the config, configFile, or auto-discovered config file loaded by stylelint.
-
stylelintplus.cssInJs:booleanRun stylelint on javascript/typescript files.
-
stylelintplus.enable:booleanDefault:
trueIf false, stylelint will not validate the file.
-
stylelintplus.filetypes:arrayDefault:
{ "css", "less", "postcss", "sass", "scss", "sugarss", "vue", "wxss" }Array items:
{type = "string"}Filetypes that coc-stylelintplus will lint.
-
stylelintplus.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Capture trace messages from the server.
-
stylelintplus.validateOnSave:booleanValidate after saving. Automatically enabled if autoFixOnSave is enabled.
-
stylelintplus.validateOnType:booleanDefault:
trueValidate after making changes.
Snippet to enable the language server:
require'lspconfig'.stylelint_lsp.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "stylelint-lsp", "--stdio" }
filetypes = { "css", "less", "scss", "sugarss", "vue", "wxss", "javascript", "javascriptreact", "typescript", "typescriptreact" }
root_dir = root_pattern('.stylelintrc', 'package.json')
settings = {}
sumneko_lua
https://github.com/sumneko/lua-language-server
Lua language server.
lua-language-server can be installed by following the instructions here.
By default, lua-language-server doesn't have a cmd set. This is because nvim-lspconfig does not make assumptions about your path. You must add the following to your init.vim or init.lua to set cmd to the absolute path ($HOME and ~ are not expanded) of your unzipped and compiled lua-language-server.
local system_name
if vim.fn.has("mac") == 1 then
system_name = "macOS"
elseif vim.fn.has("unix") == 1 then
system_name = "Linux"
elseif vim.fn.has('win32') == 1 then
system_name = "Windows"
else
print("Unsupported system for sumneko")
end
-- set the path to the sumneko installation; if you previously installed via the now deprecated :LspInstall, use
local sumneko_root_path = vim.fn.stdpath('cache')..'/lspconfig/sumneko_lua/lua-language-server'
local sumneko_binary = sumneko_root_path.."/bin/"..system_name.."/lua-language-server"
local runtime_path = vim.split(package.path, ';')
table.insert(runtime_path, "lua/?.lua")
table.insert(runtime_path, "lua/?/init.lua")
require'lspconfig'.sumneko_lua.setup {
cmd = {sumneko_binary, "-E", sumneko_root_path .. "/main.lua"};
settings = {
Lua = {
runtime = {
-- Tell the language server which version of Lua you're using (most likely LuaJIT in the case of Neovim)
version = 'LuaJIT',
-- Setup your lua path
path = runtime_path,
},
diagnostics = {
-- Get the language server to recognize the `vim` global
globals = {'vim'},
},
workspace = {
-- Make the server aware of Neovim runtime files
library = vim.api.nvim_get_runtime_file("", true),
},
-- Do not send telemetry data containing a randomized but unique identifier
telemetry = {
enable = false,
},
},
},
}
This server accepts configuration via the settings key.
Available settings:
-
Lua.IntelliSense.traceBeSetted:booleannull
-
Lua.IntelliSense.traceFieldInject:booleannull
-
Lua.IntelliSense.traceLocalSet:booleannull
-
Lua.IntelliSense.traceReturn:booleannull
-
Lua.color.mode:enum { "Grammar", "Semantic", "SemanticEnhanced" }Default:
"Semantic"null
-
Lua.completion.autoRequire:booleanDefault:
truenull
-
Lua.completion.callSnippet:enum { "Disable", "Both", "Replace" }Default:
"Disable"null
-
Lua.completion.displayContext:integerDefault:
0null
-
Lua.completion.enable:booleanDefault:
truenull
-
Lua.completion.keywordSnippet:enum { "Disable", "Both", "Replace" }Default:
"Replace"null
-
Lua.completion.postfix:stringDefault:
"@"null
-
Lua.completion.requireSeparator:stringDefault:
"."null
-
Lua.completion.showParams:booleanDefault:
truenull
-
Lua.completion.showWord:enum { "Enable", "Fallback", "Disable" }Default:
"Fallback"null
-
Lua.completion.workspaceWord:booleanDefault:
truenull
-
Lua.diagnostics.disable:arrayArray items:
{type = "string"}null
-
Lua.diagnostics.enable:booleanDefault:
truenull
-
Lua.diagnostics.globals:arrayArray items:
{type = "string"}null
-
Lua.diagnostics.ignoredFiles:enum { "Enable", "Opened", "Disable" }Default:
"Opened"null
-
Lua.diagnostics.libraryFiles:enum { "Enable", "Opened", "Disable" }Default:
"Opened"null
-
Lua.diagnostics.neededFileStatus:objectnull
-
Lua.diagnostics.severity:objectnull
-
Lua.diagnostics.workspaceDelay:integerDefault:
0null
-
Lua.diagnostics.workspaceRate:integerDefault:
100null
-
Lua.hint.enable:booleannull
-
Lua.hint.paramName:enum { "All", "Literal", "Disable" }Default:
"All"null
-
Lua.hint.paramType:booleanDefault:
truenull
-
Lua.hint.setType:booleannull
-
Lua.hover.enable:booleanDefault:
truenull
-
Lua.hover.enumsLimit:integerDefault:
5null
-
Lua.hover.previewFields:integerDefault:
20null
-
Lua.hover.viewNumber:booleanDefault:
truenull
-
Lua.hover.viewString:booleanDefault:
truenull
-
Lua.hover.viewStringMax:integerDefault:
1000null
-
Lua.misc.parameters:arrayArray items:
{type = "string"}null
-
Lua.runtime.builtin:objectnull
-
Lua.runtime.fileEncoding:enum { "utf8", "ansi", "utf16le", "utf16be" }Default:
"utf8"null
-
Lua.runtime.nonstandardSymbol:arrayArray items:
{enum = { "//", "/**/", "", "+=", "-=", "*=", "/=", "||", "&&", "!", "!=", "continue" },type = "string"}`null
-
Lua.runtime.path:arrayDefault:
{ "?.lua", "?/init.lua" }Array items:
{type = "string"}null
-
Lua.runtime.pathStrict:booleannull
-
Lua.runtime.plugin:stringDefault:
""null
-
Lua.runtime.special:objectnull
-
Lua.runtime.unicodeName:booleannull
-
Lua.runtime.version:enum { "Lua 5.1", "Lua 5.2", "Lua 5.3", "Lua 5.4", "LuaJIT" }Default:
"Lua 5.4"null
-
Lua.signatureHelp.enable:booleanDefault:
truenull
-
Lua.telemetry.enable:boolean|nullDefault:
vim.NILnull
-
Lua.window.progressBar:booleanDefault:
truenull
-
Lua.window.statusBar:booleanDefault:
truenull
-
Lua.workspace.checkThirdParty:booleanDefault:
truenull
-
Lua.workspace.ignoreDir:arrayDefault:
{ ".vscode" }Array items:
{type = "string"}null
-
Lua.workspace.ignoreSubmodules:booleanDefault:
truenull
-
Lua.workspace.library:arrayArray items:
{type = "string"}null
-
Lua.workspace.maxPreload:integerDefault:
1000null
-
Lua.workspace.preloadFileSize:integerDefault:
100null
-
Lua.workspace.useGitIgnore:booleanDefault:
truenull
-
Lua.workspace.userThirdParty:arrayArray items:
{type = "string"}null
Snippet to enable the language server:
require'lspconfig'.sumneko_lua.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "lua" }
log_level = 2
root_dir = root_pattern(".git") or bufdir
settings = {
Lua = {
telemetry = {
enable = false
}
}
}
single_file_support = true
svelte
https://github.com/sveltejs/language-tools/tree/master/packages/language-server
svelte-language-server can be installed via npm:
npm install -g svelte-language-server
Snippet to enable the language server:
require'lspconfig'.svelte.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "svelteserver", "--stdio" }
filetypes = { "svelte" }
root_dir = root_pattern("package.json", ".git")
svls
https://github.com/dalance/svls
Language server for verilog and SystemVerilog
svls can be installed via cargo:
cargo install svls
Snippet to enable the language server:
require'lspconfig'.svls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "svls" }
filetypes = { "verilog", "systemverilog" }
root_dir = util.find_git_ancestor
tailwindcss
https://github.com/tailwindlabs/tailwindcss-intellisense
Tailwind CSS Language Server can be installed via npm:
npm install -g @tailwindcss/language-server
Snippet to enable the language server:
require'lspconfig'.tailwindcss.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "tailwindcss-language-server", "--stdio" }
filetypes = { "aspnetcorerazor", "astro", "astro-markdown", "blade", "django-html", "edge", "eelixir", "ejs", "erb", "eruby", "gohtml", "haml", "handlebars", "hbs", "html", "html-eex", "jade", "leaf", "liquid", "markdown", "mdx", "mustache", "njk", "nunjucks", "php", "razor", "slim", "twig", "css", "less", "postcss", "sass", "scss", "stylus", "sugarss", "javascript", "javascriptreact", "reason", "rescript", "typescript", "typescriptreact", "vue", "svelte" }
init_options = {
userLanguages = {
eelixir = "html-eex",
eruby = "erb"
}
}
on_new_config = function(new_config)
if not new_config.settings then
new_config.settings = {}
end
if not new_config.settings.editor then
new_config.settings.editor = {}
end
if not new_config.settings.editor.tabSize then
-- set tab size for hover
new_config.settings.editor.tabSize = vim.lsp.util.get_effective_tabstop()
end
end,
root_dir = root_pattern('tailwind.config.js', 'tailwind.config.ts', 'postcss.config.js', 'postcss.config.ts', 'package.json', 'node_modules', '.git')
settings = {
tailwindCSS = {
classAttributes = { "class", "className", "classList", "ngClass" },
lint = {
cssConflict = "warning",
invalidApply = "error",
invalidConfigPath = "error",
invalidScreen = "error",
invalidTailwindDirective = "error",
invalidVariant = "error",
recommendedVariantOrder = "warning"
},
validate = true
}
}
taplo
https://taplo.tamasfe.dev/lsp/
Language server for Taplo, a TOML toolkit.
taplo-lsp can be installed via cargo:
cargo install taplo-lsp
Snippet to enable the language server:
require'lspconfig'.taplo.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "taplo-lsp", "run" }
filetypes = { "toml" }
root_dir = root_pattern("*.toml", ".git")
single_file_support = true
terraform_lsp
https://github.com/juliosueiras/terraform-lsp
Terraform language server Download a released binary from https://github.com/juliosueiras/terraform-lsp/releases.
From https://github.com/hashicorp/terraform-ls#terraform-ls-vs-terraform-lsp:
Both HashiCorp and the maintainer of terraform-lsp expressed interest in collaborating on a language server and are working towards a long-term goal of a single stable and feature-complete implementation.
For the time being both projects continue to exist, giving users the choice:
-
terraform-lsproviding- overall stability (by relying only on public APIs)
- compatibility with any provider and any Terraform >=0.12.0 currently less features
- due to project being younger and relying on public APIs which may not offer the same functionality yet
-
terraform-lspproviding- currently more features
- compatibility with a single particular Terraform (0.12.20 at time of writing)
- configs designed for other 0.12 versions may work, but interpretation may be inaccurate
- less stability (due to reliance on Terraform's own internal packages)
Snippet to enable the language server:
require'lspconfig'.terraform_lsp.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "terraform-lsp" }
filetypes = { "terraform", "hcl" }
root_dir = root_pattern(".terraform", ".git")
terraformls
https://github.com/hashicorp/terraform-ls
Terraform language server Download a released binary from https://github.com/hashicorp/terraform-ls/releases.
From https://github.com/hashicorp/terraform-ls#terraform-ls-vs-terraform-lsp:
Both HashiCorp and the maintainer of terraform-lsp expressed interest in collaborating on a language server and are working towards a long-term goal of a single stable and feature-complete implementation.
For the time being both projects continue to exist, giving users the choice:
-
terraform-lsproviding- overall stability (by relying only on public APIs)
- compatibility with any provider and any Terraform >=0.12.0 currently less features
- due to project being younger and relying on public APIs which may not offer the same functionality yet
-
terraform-lspproviding- currently more features
- compatibility with a single particular Terraform (0.12.20 at time of writing)
- configs designed for other 0.12 versions may work, but interpretation may be inaccurate
- less stability (due to reliance on Terraform's own internal packages)
This server accepts configuration via the settings key.
Available settings:
-
terraform-ls.excludeRootModules:arrayDefault:
{}Array items:
{type = "string"}Per-workspace list of module directories for the language server to exclude
-
terraform-ls.experimentalFeatures:objectExperimental (opt-in) terraform-ls features
-
terraform-ls.ignoreDirectoryNames:arrayDefault:
{}Array items:
{type = "string"}Per-workspace list of directory names for the language server to ignore when indexing files
-
terraform-ls.rootModules:arrayDefault:
{}Array items:
{type = "string"}Per-workspace list of module directories for the language server to read
-
terraform-ls.terraformExecPath:stringPath to the Terraform binary
-
terraform-ls.terraformExecTimeout:stringOverrides Terraform execution timeout (e.g. 30s)
-
terraform-ls.terraformLogFilePath:stringPath to a file for Terraform executions to be logged into (TF_LOG_PATH) with support for variables (e.g. Timestamp, Pid, Ppid) via Go template syntax {{.VarName}}
-
terraform.codelens.referenceCount:booleanDefault:
trueDisplay reference counts above top level blocks and attributes.
-
terraform.languageServer:objectDefault:
{args = { "serve" },external = true,maxNumberOfProblems = 100,pathToBinary = "",["trace.server"] = "off"}Language Server settings
Snippet to enable the language server:
require'lspconfig'.terraformls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "terraform-ls", "serve" }
filetypes = { "terraform" }
root_dir = root_pattern(".terraform", ".git")
texlab
https://github.com/latex-lsp/texlab
A completion engine built from scratch for (La)TeX.
See https://github.com/latex-lsp/texlab/blob/master/docs/options.md for configuration options.
Snippet to enable the language server:
require'lspconfig'.texlab.setup{}
Commands and default values:
Commands:
- TexlabBuild: Build the current buffer
- TexlabForward: Forward search from current position
Default Values:
cmd = { "texlab" }
filetypes = { "tex", "bib" }
root_dir = function(fname)
return util.root_pattern '.latexmkrc'(fname) or util.find_git_ancestor(fname)
end,
settings = {
texlab = {
auxDirectory = ".",
bibtexFormatter = "texlab",
build = {
args = { "-pdf", "-interaction=nonstopmode", "-synctex=1", "%f" },
executable = "latexmk",
forwardSearchAfter = false,
onSave = false
},
chktex = {
onEdit = false,
onOpenAndSave = false
},
diagnosticsDelay = 300,
formatterLineLength = 80,
forwardSearch = {
args = {}
},
latexFormatter = "latexindent",
latexindent = {
modifyLineBreaks = false
}
}
}
single_file_support = true
tflint
https://github.com/terraform-linters/tflint
A pluggable Terraform linter that can act as lsp server. Installation instructions can be found in https://github.com/terraform-linters/tflint#installation.
Snippet to enable the language server:
require'lspconfig'.tflint.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "tflint", "--langserver" }
filetypes = { "terraform" }
root_dir = root_pattern(".terraform", ".git", ".tflint.hcl")
theme_check
https://github.com/Shopify/shopify-cli
theme-check-language-server is bundled with shopify-cli or it can also be installed via
https://github.com/Shopify/theme-check#installation
NOTE:
If installed via Homebrew, cmd must be set to 'theme-check-liquid-server'
require lspconfig.theme_check.setup {
cmd = { 'theme-check-liquid-server' }
}
Snippet to enable the language server:
require'lspconfig'.theme_check.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "theme-check-language-server", "--stdio" }
filetypes = { "liquid" }
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
settings = {}
tsserver
https://github.com/theia-ide/typescript-language-server
typescript-language-server depends on typescript. Both packages can be installed via npm:
npm install -g typescript typescript-language-server
To configure type language server, add a
tsconfig.json or
jsconfig.json to the root of your
project.
Here's an example that disables type checking in JavaScript files.
{
"compilerOptions": {
"module": "commonjs",
"target": "es6",
"checkJs": false
},
"exclude": [
"node_modules"
]
}
Snippet to enable the language server:
require'lspconfig'.tsserver.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "typescript-language-server", "--stdio" }
filetypes = { "javascript", "javascriptreact", "javascript.jsx", "typescript", "typescriptreact", "typescript.tsx" }
init_options = {
hostInfo = "neovim"
}
root_dir = root_pattern("package.json", "tsconfig.json", "jsconfig.json", ".git")
typeprof
https://github.com/ruby/typeprof
typeprof is the built-in analysis and LSP tool for Ruby 3.1+.
Snippet to enable the language server:
require'lspconfig'.typeprof.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "typeprof", "--lsp", "--stdio" }
filetypes = { "ruby", "eruby" }
root_dir = root_pattern("Gemfile", ".git")
vala_ls
https://github.com/Prince781/vala-language-server
Snippet to enable the language server:
require'lspconfig'.vala_ls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "vala-language-server" }
filetypes = { "vala", "genie" }
root_dir = root_pattern("meson.build", ".git")
single_file_support = true
vdmj
https://github.com/nickbattle/vdmj
The VDMJ language server can be installed by cloning the VDMJ repository and
running mvn clean install.
Various options are provided to configure the language server (see below). In particular:
annotation_pathsis a list of folders and/or jar file paths for annotations that should be used with the language server;- any value of
debugger_portless than zero will disable the debugger; note that if a non-zero value is used, only one instance of the server can be active at a time.
More settings for VDMJ can be changed in a file called vdmj.properties under
root_dir/.vscode. For a description of the available settings, see
Section 7 of the VDMJ User Guide.
Note: proof obligations and combinatorial testing are not currently supported by neovim.
Snippet to enable the language server:
require'lspconfig'.vdmj.setup{}
Commands and default values:
Commands:
Default Values:
cmd = Generated from the options given
filetypes = { "vdmsl", "vdmpp", "vdmrt" }
options = {
annotation_paths = {},
debugger_port = -1,
high_precision = false,
java = "$JAVA_HOME/bin/java",
java_opts = { "-Xmx3000m", "-Xss1m" },
logfile = "path.join(vim.fn.stdpath 'cache', 'vdm-lsp.log')",
mavenrepo = "$HOME/.m2/repository/com/fujitsu",
version = "The latest version installed in `mavenrepo`"
}
root_dir = util.find_git_ancestor(fname) or find_vscode_ancestor(fname)
vimls
https://github.com/iamcco/vim-language-server
You can install vim-language-server via npm:
npm install -g vim-language-server
Snippet to enable the language server:
require'lspconfig'.vimls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "vim-language-server", "--stdio" }
filetypes = { "vim" }
init_options = {
diagnostic = {
enable = true
},
indexes = {
count = 3,
gap = 100,
projectRootPatterns = { "runtime", "nvim", ".git", "autoload", "plugin" },
runtimepath = true
},
iskeyword = "@,48-57,_,192-255,-#",
runtimepath = "",
suggest = {
fromRuntimepath = true,
fromVimruntime = true
},
vimruntime = ""
}
root_dir = function(fname)
return util.find_git_ancestor(fname) or vim.fn.getcwd()
end,
vls
V language server.
v-language-server can be installed by following the instructions here.
By default, v-language-server doesn't have a cmd set. This is because nvim-lspconfig does not make assumptions about your path. You must add the following to your init.vim or init.lua to set cmd to the absolute path ($HOME and ~ are not expanded) of your unzipped and compiled v-language-server.
-- set the path to the vls installation;
local vls_root_path = vim.fn.stdpath('cache')..'/lspconfig/vls'
local vls_binary = vls_root_path.."/cmd/vls/vls"
require'lspconfig'.vls.setup {
cmd = {vls_binary},
}
Snippet to enable the language server:
require'lspconfig'.vls.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "vlang" }
root_dir = root_pattern("v.mod", ".git")
volar
https://github.com/johnsoncodehk/volar/tree/master/packages/server
Volar language server for Vue
Volar can be installed via npm:
npm install -g @volar/server
Volar by default supports Vue 3 projects. Vue 2 projects need additional configuration.
Take Over Mode Volar can serve as a language server for both Vue and TypeScript via Take Over Mode.
To enable Take Over Mode, override the default filetypes in setup{} as follows:
require'lspconfig'.volar.setup{
filetypes = {'typescript', 'javascript', 'javascriptreact', 'typescriptreact', 'vue', 'json'}
}
Overriding the default TypeScript Server used by Volar The default config looks for TS in the local node_modules. The alternatives are:
- use a global TypeScript Server installation
require'lspconfig'.volar.setup{
init_options = {
typescript = {
serverPath = '/path/to/.npm/lib/node_modules/typescript/lib/tsserverlib.js'
}
}
}
- use a global TypeScript Server installation if a local server is not found
local util = require 'lspconfig.util'
local function get_typescript_server_path(root_dir)
local project_root = util.find_node_modules_ancestor(root_dir)
local local_tsserverlib = project_root ~= nil and util.path.join(project_root, 'node_modules', 'typescript', 'lib', 'tsserverlibrary.js')
local global_tsserverlib = '/home/[yourusernamehere]/.npm/lib/node_modules/typescript/lib/tsserverlibrary.js'
if local_tsserverlib and util.path.exists(local_tsserverlib) then
return local_tsserverlib
else
return global_tsserverlib
end
end
require'lspconfig'.volar.setup{
config = {
on_new_config = function(new_config, new_root_dir)
new_config.init_options.typescript.serverPath = get_typescript_server_path(new_root_dir)
end,
}
}
Snippet to enable the language server:
require'lspconfig'.volar.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "volar-server", "--stdio" }
filetypes = { "vue" }
init_options = {
documentFeatures = {
documentColor = false,
documentFormatting = {
defaultPrintWidth = 100
},
documentSymbol = true,
foldingRange = true,
linkedEditingRange = true,
selectionRange = true
},
languageFeatures = {
callHierarchy = true,
codeAction = true,
codeLens = true,
completion = {
defaultAttrNameCase = "kebabCase",
defaultTagNameCase = "both"
},
definition = true,
diagnostics = true,
documentHighlight = true,
documentLink = true,
hover = true,
references = true,
rename = true,
renameFileRefactoring = true,
schemaRequestService = true,
semanticTokens = false,
signatureHelp = true,
typeDefinition = true
},
typescript = {
serverPath = ""
}
}
on_new_config = function(new_config, new_root_dir)
if
new_config.init_options
and new_config.init_options.typescript
and new_config.init_options.typescript.serverPath == ''
then
new_config.init_options.typescript.serverPath = get_typescript_server_path(new_root_dir)
end
end,
root_dir = function(startpath)
return M.search_ancestors(startpath, matcher)
end
vuels
https://github.com/vuejs/vetur/tree/master/server
Vue language server(vls)
vue-language-server can be installed via npm:
npm install -g vls
This server accepts configuration via the settings key.
Available settings:
-
vetur.completion.autoImport:booleanDefault:
trueInclude completion for module export and auto import them
-
vetur.completion.scaffoldSnippetSources:objectDefault:
{user = "🗒️",vetur = "✌",workspace = "💼"}Where Vetur source Scaffold Snippets from and how to indicate them. Set a source to "" to disable it.
- workspace: `<WORKSPACE>/.vscode/vetur/snippets`. - user: `<USER-DATA-DIR>/User/snippets/vetur`. - vetur: Bundled in Vetur.
The default is: ``` "vetur.completion.scaffoldSnippetSources": { "workspace": "💼", "user": "🗒️", "vetur": "✌" } ```
Alternatively, you can do:
``` "vetur.completion.scaffoldSnippetSources": { "workspace": "(W)", "user": "(U)", "vetur": "(V)" } ```
Read more: https://vuejs.github.io/vetur/snippet.html.
-
vetur.completion.tagCasing:enum { "initial", "kebab" }Default:
"kebab"Casing conversion for tag completion
-
vetur.dev.logLevel:enum { "INFO", "DEBUG" }Default:
"INFO"Log level for VLS
-
vetur.dev.vlsPath:stringPath to vls for Vetur developers. There are two ways of using it.
1. Clone vuejs/vetur from GitHub, build it and point it to the ABSOLUTE path of `/server`. 2. `yarn global add vls` and point Vetur to the installed location (`yarn global dir` + node_modules/vls)
-
vetur.dev.vlsPort:numberDefault:
-1The port that VLS listens to. Can be used for attaching to the VLS Node process for debugging / profiling.
-
vetur.experimental.templateInterpolationService:booleanEnable template interpolation service that offers hover / definition / references in Vue interpolations.
-
vetur.format.defaultFormatter.css:enum { "none", "prettier" }Default:
"prettier"Default formatter for <style> region
-
vetur.format.defaultFormatter.html:enum { "none", "prettyhtml", "js-beautify-html", "prettier" }Default:
"prettier"Default formatter for <template> region
-
vetur.format.defaultFormatter.js:enum { "none", "prettier", "prettier-eslint", "vscode-typescript" }Default:
"prettier"Default formatter for <script> region
-
vetur.format.defaultFormatter.less:enum { "none", "prettier" }Default:
"prettier"Default formatter for <style lang='less'> region
-
vetur.format.defaultFormatter.postcss:enum { "none", "prettier" }Default:
"prettier"Default formatter for <style lang='postcss'> region
-
vetur.format.defaultFormatter.pug:enum { "none", "prettier" }Default:
"prettier"Default formatter for <template lang='pug'> region
-
vetur.format.defaultFormatter.sass:enum { "none", "sass-formatter" }Default:
"sass-formatter"Default formatter for <style lang='sass'> region
-
vetur.format.defaultFormatter.scss:enum { "none", "prettier" }Default:
"prettier"Default formatter for <style lang='scss'> region
-
vetur.format.defaultFormatter.stylus:enum { "none", "stylus-supremacy" }Default:
"stylus-supremacy"Default formatter for <style lang='stylus'> region
-
vetur.format.defaultFormatter.ts:enum { "none", "prettier", "prettier-tslint", "vscode-typescript" }Default:
"prettier"Default formatter for <script> region
-
vetur.format.defaultFormatterOptions:objectDefault:
{["js-beautify-html"] = {wrap_attributes = "force-expand-multiline"},prettyhtml = {printWidth = 100,singleQuote = false,sortAttributes = false,wrapAttributes = false}}Options for all default formatters
-
vetur.format.enable:booleanDefault:
trueEnable/disable the Vetur document formatter.
-
vetur.format.options.tabSize:numberDefault:
2Number of spaces per indentation level. Inherited by all formatters.
-
vetur.format.options.useTabs:booleanUse tabs for indentation. Inherited by all formatters.
-
vetur.format.scriptInitialIndent:booleanWhether to have initial indent for <script> region
-
vetur.format.styleInitialIndent:booleanWhether to have initial indent for <style> region
-
vetur.grammar.customBlocks:objectDefault:
{docs = "md",i18n = "json"}Mapping from custom block tag name to language name. Used for generating grammar to support syntax highlighting for custom blocks.
-
vetur.ignoreProjectWarning:booleanVetur will warn about not setup correctly for the project. You can disable it.
-
vetur.languageFeatures.codeActions:booleanDefault:
trueWhether to enable codeActions
-
vetur.languageFeatures.semanticTokens:booleanDefault:
trueWhether to enable semantic highlighting. Currently only works for typescript
-
vetur.languageFeatures.updateImportOnFileMove:booleanDefault:
trueWhether to automatic updating import path when rename or move a file
-
vetur.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VS Code and Vue Language Server.
-
vetur.underline.refValue:booleanDefault:
trueEnable underline `.value` when using composition API.
-
vetur.useWorkspaceDependencies:booleanUse dependencies from workspace. Support for TypeScript, Prettier, @starptech/prettyhtml, prettier-eslint, prettier-tslint, stylus-supremacy, @prettier/plugin-pug.
-
vetur.validation.interpolation:booleanDefault:
trueValidate interpolations in <template> region using TypeScript language service
-
vetur.validation.script:booleanDefault:
trueValidate js/ts in <script>
-
vetur.validation.style:booleanDefault:
trueValidate css/scss/less/postcss in <style>
-
vetur.validation.template:booleanDefault:
trueValidate vue-html in <template> using eslint-plugin-vue
-
vetur.validation.templateProps:booleanValidate props usage in <template> region. Show error/warning for not passing declared props to child components and show error for passing wrongly typed interpolation expressions
Snippet to enable the language server:
require'lspconfig'.vuels.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "vls" }
filetypes = { "vue" }
init_options = {
config = {
css = {},
emmet = {},
html = {
suggest = {}
},
javascript = {
format = {}
},
stylusSupremacy = {},
typescript = {
format = {}
},
vetur = {
completion = {
autoImport = false,
tagCasing = "kebab",
useScaffoldSnippets = false
},
format = {
defaultFormatter = {
js = "none",
ts = "none"
},
defaultFormatterOptions = {},
scriptInitialIndent = false,
styleInitialIndent = false
},
useWorkspaceDependencies = false,
validation = {
script = true,
style = true,
template = true
}
}
}
}
root_dir = root_pattern("package.json", "vue.config.js")
yamlls
https://github.com/redhat-developer/yaml-language-server
yaml-language-server can be installed via yarn:
yarn global add yaml-language-server
To use a schema for validation, there are two options:
- Add a modeline to the file. A modeline is a comment of the form:
# yaml-language-server: $schema=<urlToTheSchema|relativeFilePath|absoluteFilePath}>
where the relative filepath is the path relative to the open yaml file, and the absolute filepath is the filepath relative to the filesystem root ('/' on unix systems)
- Associated a schema url, relative , or absolute (to root of project, not to filesystem root) path to
the a glob pattern relative to the detected project root. Check
:LspInfoto determine the resolved project root.
require('lspconfig').yamlls.setup {
... -- other configuration for setup {}
settings = {
yaml = {
... -- other settings. note this overrides the lspconfig defaults.
schemas = {
["https://json.schemastore.org/github-workflow.json"] = "/.github/workflows/*"
["../path/relative/to/file.yml"] = "/.github/workflows/*"
["/path/from/root/of/project"] = "/.github/workflows/*"
},
},
}
}
Currently, kubernetes is special-cased in yammls, see the following upstream issues:
To override a schema to use a specific k8s schema version (for example, to use 1.18):
require('lspconfig').yamlls.setup {
... -- other configuration for setup {}
settings = {
yaml = {
... -- other settings. note this overrides the lspconfig defaults.
schemas = {
["https://raw.githubusercontent.com/instrumenta/kubernetes-json-schema/master/v1.18.0-standalone-strict/all.json"] = "/*.k8s.yaml",
... -- other schemas
},
},
}
}
This server accepts configuration via the settings key.
Available settings:
-
redhat.telemetry.enabled:booleanDefault:
vim.NILnull
-
yaml.completion:booleanDefault:
trueEnable/disable completion feature
-
yaml.customTags:arrayDefault:
{}Custom tags for the parser to use
-
yaml.disableAdditionalProperties:booleanGlobally set additionalProperties to false for all objects. So if its true, no extra properties are allowed inside yaml.
-
yaml.format.bracketSpacing:booleanDefault:
truePrint spaces between brackets in objects
-
yaml.format.enable:booleanDefault:
trueEnable/disable default YAML formatter
-
yaml.format.printWidth:integerDefault:
80Specify the line length that the printer will wrap on
-
yaml.format.proseWrap:enum { "preserve", "never", "always" }Default:
"preserve"Always: wrap prose if it exeeds the print width, Never: never wrap the prose, Preserve: wrap prose as-is
-
yaml.format.singleQuote:booleanUse single quotes instead of double quotes
-
yaml.hover:booleanDefault:
trueEnable/disable hover feature
-
yaml.maxItemsComputed:integerDefault:
5000The maximum number of outline symbols and folding regions computed (limited for performance reasons).
-
yaml.schemaStore.enable:booleanDefault:
trueAutomatically pull available YAML schemas from JSON Schema Store
-
yaml.schemaStore.url:stringDefault:
"https://www.schemastore.org/api/json/catalog.json"URL of schema store catalog to use
-
yaml.schemas:objectDefault:
vim.empty_dict()Associate schemas to YAML files in the current workspace
-
yaml.trace.server:enum { "off", "messages", "verbose" }Default:
"off"Traces the communication between VSCode and the YAML language service.
-
yaml.validate:booleanDefault:
trueEnable/disable validation feature
Snippet to enable the language server:
require'lspconfig'.yamlls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "yaml-language-server", "--stdio" }
filetypes = { "yaml", "yaml.docker-compose" }
root_dir = util.find_git_ancestor
settings = {
redhat = {
telemetry = {
enabled = false
}
}
}
single_file_support = true
zeta_note
https://github.com/artempyanykh/zeta-note
Markdown LSP server for easy note-taking with cross-references and diagnostics.
Binaries can be downloaded from https://github.com/artempyanykh/zeta-note/releases
By default, zeta-note doesn't have a cmd set. This is because nvim-lspconfig does not make assumptions about your path. You must add the following to your init.vim or init.lua to set cmd to the absolute path ($HOME and ~ are not expanded) of your zeta-note binary.
require'lspconfig'.zeta_note.setup{
cmd = {'path/to/zeta-note'}
}
This server accepts configuration via the settings key.
Available settings:
-
zetaNote.customCommand:stringWhen set use this command to run the language server. The command is split on spaces: first part is the command name, the rest is the arguments.
-
zetaNote.customCommandDir:stringnull
-
zetaNote.trace.server:enum { "off", "messages", "verbose" }Default:
"verbose"Level of verbosity in communicating with the server
Snippet to enable the language server:
require'lspconfig'.zeta_note.setup{}
Commands and default values:
Commands:
Default Values:
filetypes = { "markdown" }
root_dir = root_pattern(".zeta.toml")
zk
github.com/mickael-menu/zk
A plain text note-taking assistant
Snippet to enable the language server:
require'lspconfig'.zk.setup{}
Commands and default values:
Commands:
- ZkIndex: Index
- ZkNew: ZkNew
Default Values:
cmd = { "zk", "lsp" }
filetypes = { "markdown" }
root_dir = root_pattern(".zk")
zls
https://github.com/zigtools/zls
`Zig LSP implementation + Zig Language Server`.
Snippet to enable the language server:
require'lspconfig'.zls.setup{}
Commands and default values:
Commands:
Default Values:
cmd = { "zls" }
filetypes = { "zig", "zir" }
root_dir = util.root_pattern("zls.json", ".git") or current_file_dirname
single_file_support = true
vim:ft=markdown