doomemacs/modules/tools/lsp/README.org

:tools lsp

• Description
  • Maintainers
  • Module flags
  • Packages
  • Hacks
  • Changelog
• Installation
• Usage
  • LSP-powered project search
  • Differences between eglot and lsp-mode
• Configuration
  • Turn off lsp-mode's intrusive features
• Troubleshooting
  • My language server is not found
  • LSP/Eglot is not started automatically in my buffer
  • LSP is slow
• Frequently asked questions
• Appendix

← Back to module index ! Issues ↖ Github ± Suggest edits ? Help

---

Description   unfold

This module integrates language servers into Doom Emacs. They provide features you'd expect from IDEs, like code completion, realtime linting, language-aware imenu/xref integration, jump-to-definition/references support, and more.

As of this writing, this is the state of LSP support in Doom Emacs:

Module	Major modes	Default language server
:lang cc	c-mode, c++-mode, objc-mode	ccls, clangd
:lang clojure	clojure-mode	clojure-lsp
:lang csharp	csharp-mode	omnisharp
:lang elixir	elixir-mode	elixir-ls
:lang fsharp	fsharp-mode	Mono, .NET core
:lang go	go-mode	go-langserver
:lang haskell	haskell-mode	haskell-language-server
:lang java	java-mode	lsp-java
:lang javascript	js2-mode, rjsx-mode, typescript-mode	ts-ls, deno-ls
:lang julia	julia-mode	LanguageServer.jl
:lang ocaml	tuareg-mode	ocaml-language-server
:lang php	php-mode	php-language-server
:lang purescript	purescript-mode	purescript-language-server
:lang python	python-mode	lsp-python-ms
:lang ruby	ruby-mode	solargraph
:lang rust	rust-mode	rls
:lang scala	scala-mode	metals
:lang sh	sh-mode	bash-language-server
:lang swift	swift-mode	sourcekit
:lang web	web-mode, css-mode, scss-mode, sass-mode, less-css-mode	vscode-css-languageserver-bin, vscode-html-languageserver-bin
:lang zig	zig-mode	zls

Maintainers

This module has no dedicated maintainers. Become a maintainer?

Module flags

+eglot

Use Eglot instead of LSP-mode to implement the LSP client in Emacs.

+peek

Use lsp-ui-peek when looking up definitions and references with functionality from the :tools lookup module.

Packages

• lsp-mode
• lsp-ui
• lsp-ivy (:completion ivy)
• helm-lsp (:completion helm)
• consult-lsp (:completion vertico)
• eglot

Hacks

No hacks documented for this module.

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

To get LSP working, you'll need to do three things:

1. Enable this module,
2. Install a language server appropriate for your targeted language(s).
3. Enable the +lsp flag on the :lang modules you want to enable LSP support for.

Different languages will need different language servers, some of which lsp-mode will prompt you to auto-install, but eglot will not.

A table that lists available language servers and how to install them can be found on the lsp-mode project README. The documentation of the module for your targeted language will contain brief instructions as well.

For eglot users, a list of default servers supported is on Eglot's README, including instructions to register your own.

TODO Usage

🔨 This module's usage documentation is incomplete. Complete it?

LSP-powered project search

Without the +eglot flag, and when :completion ivy, :completion helm or :completion vertico is active, LSP is used to search a symbol indexed by the LSP server:

Keybind	Description
SPC c j	Jump to symbol in current workspace
SPC c J	Jump to symbol in any workspace

Differences between eglot and lsp-mode

Entering the debate about which one to use would be useless. Doom provides an easy way to switch out lsp client implementations so you can test for yourself which one you prefer.

Mainly, from a code point of view, lsp-mode has a lot of custom code for UI (lsp-ui-peek, lsp-ui-sideline, …), while eglot is more barebones with a closer integration with "more basic" emacs packages (eldoc, xref, …).

TODO Configuration

🔨 This module's configuration documentation is incomplete. Complete it?

Turn off lsp-mode's intrusive features

Many users may not like how many UI elements that lsp-mode adds. They have some excellent documentation outlining what these features are called and how to turn them off.

Troubleshooting

Report an issue?

My language server is not found

Check the entry in the FAQ about "Doom can't find my executables/doesn't inherit the correct PATH"

LSP/Eglot is not started automatically in my buffer

Make sure that you have enabled the +lsp flag on the appropriate module(s) (in your doom! block in $DOOMDIR/init.el):

:lang
-python
+(python +lsp)

LSP is slow

Follow lsp-tuning-guide to further fine-tune LSP mode performance.

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

🔨 This module has no appendix yet. Write one?