Have you read all the documentation at ensime.org/editors/emacs? Please do, we put a lot of effort into it.
Most problems can be resolved easily by following a simple process. Please do not skip these steps.
Problem starting the ENSIME server
M-x list-packages RET U RET x.
- follow the troubleshooting guide for your build tool plugin and re-run the
.ensimegenerator, e.g. the
- check the
*ENSIME-...*server buffer for exceptions. If there is anything suspicious, kill the buffer (this stops the server), delete the
.ensime_cache, and restart.
Problem with red squiggly lines and broken completion / types
As a side effect, you’re probably experiencing hanging, remember to
ESC ESC ESC to get Emacs back instantly.
- compile your project, or open all dependent scala files
- restart the presentation compiler:
C-c C-c r(
- try restarting the server with
- read the
- get more information by debugging emacs
If that solved your problem, great!
If not, please join the conversation at gitter.im/ensime/ensime-emacs and let it be known that you have followed this guide, and the linked guides, by introducing yourself with “wibble wibble I’m a fish”, so that we know you read this far. If you do not provide a reproduction in the form of a project, it is extremely unlikely that anybody will be able to help you.
Do not post stacktraces on the gitter channel, instead yank the contents of
M-x ensime-troubleshooting into a gist.
Remember, everybody is here to help, but nobody is paid to maintain ENSIME (not even the sponsored developers). For ENSIME to be sustainable, we need you to engage in the bug fixing process rather heavily and (ideally) submit a pull request with a fix.