M-x lsp-doctor to validate if your
lsp-mode is properly configured. In the section below, you could find description for each of the checks:
When configured properly
lsp-mode's performance is on par with mainstream LSP clients (e. g.
Theia, etc). Here are steps to achieve optimal results.
Use Emacs 27+ with native json support. (Note: this requires that you have libjansson installed, and that emacs was compiled with `–with-json` passed to `./configure`.) You can check your installation for native json support by running M-:
(functionp 'json-serialize)RET. Benchmarks show that Emacs 27 is
~15 timesfaster than Emacs when using Elisp json parser implementation.
gc-cons-threshold. The default setting is too low for
lsp-mode's needs due to the fact that client/server communication generates a lot of memory/garbage. You have two options:
- Set it to big number(100mb) like most of the popular starter kits like Spacemacs/Doom/Prelude, etc do:
(setq gc-cons-threshold 100000000)
- Follow the method recommended by Gnu Emacs Maintainer Eli Zaretskii: "My suggestion is to repeatedly multiply gc-cons-threshold by 2 until you stop seeing significant improvements in responsiveness, and in any case not to increase by a factor larger than 100 or somesuch. If even a 100-fold increase doesn't help, there's some deeper problem with the Lisp code which produces so much garbage, or maybe GC is not the reason for slowdown." Source: https://www.reddit.com/r/emacs/comments/brc05y/is_lspmode_too_slow_to_use_for_anyone_else/eofulix/
Increase the amount of data which Emacs reads from the process. Again the emacs default is too low 4k considering that the some of the language server responses are in 800k - 3M range.
(setq read-process-output-max (* 1024 1024)) ;; 1mb
- Optional: Disable
lsp-uiis very fast but in some systems (especially when using
lsp-uioverlays and popups might slow down emacs.
- Optional: fine-tune
lsp-idle-delay. This variable determines how often lsp-mode will refresh the highlights, lenses, links, etc while you type.
(setq lsp-idle-delay 0.500)
gccemacs is a bleeding-edge version of
Emacs that compiles elisp to native code, resulting in more than 200% speedup. For everyone looking for optimal performance,
gccemacs is the way to go.
Ignore watch folders/files#
If the server supports watch files, by default
lsp-mode tries to watch all files and folders of the project ignoring the regexp from
lsp-file-watch-ignored. If you don't want some file or folder
to be watched for performance reasons, you can add a regexp to that variable excluding the file or folder.
Check the file watchers section for details.
Check if logging is switched off.#
nil. You might have forgotten it after a debugging session, for example. It can cause a great performance hit.
(setq lsp-log-io nil) ; if set to true can cause a performance hit
Sometimes you might need to check logging for specific LSP server configuration as well, i.e. for
lsp-eslint it is:
Reporting performance problems#
If you have tried all of the non-optional steps from the list and
emacs is still not very responsive please open a PR with the following information:
- Include emacs performance report. Use the following step to collect it:
M-x profiler-startand select
- Reproduce the slow behavior.
- In the profiler report expand all nodes by doing
lsp-mode is just a frontend and the performance depends on server as well. Some servers (e. g. Palantir's Python Language Server) might be slow when performing auto-completion.