In days of yore, getting C#/dotnet working in emacs with intellisense
was a bit arcane because
did not exist.
Now those modes exist, and
eglot as well as
csharp-mode have been absorbed into upstream emacs, which
means this article is obsolete. I'm leaving it up for posterity in case
someone out there is running a pre-29 emacs.
Note that in emacs 29 you'd also do well to use
csharp-ts-mode instead of just
install the applicable language grammar for
Writing C# in Emacs
06 December 2020
I contribute to an open source project written in C# that I helped port to dotnet core (and thus natively to mac and linux) and when I mentioned it recently on Hacker News I was asked to comment on my setup for writing C# on emacs, while still gaining the benefits of Intellisense-style code completion.
Writing C# in Emacs depends on just a handful of packages:
- csharp-mode for syntax highlighting and indentation
- company-mode as the code completion frontend
- an implementation of a Language Server, via lsp-mode, as the code completion backend
I happen to use the use-package macro to simplify my emacs config, so that's how these examples will be presented, but this setup will work without it.
Pretty straightforward declaration. I've added two hooks so that company and rainbow-delimiters will automatically be invoked when we invoke csharp mode (or when we open a .cs file).
use-package csharp-mode :ensure t
(add-hook 'csharp-mode-hook #'rainbow-delimiters-mode))(add-hook
Next let's add company mode to our init. Previous versions of this page had company-omnisharp in here, but that is no longer required with lsp-mode.
use-package company :ensure t :mode "company-mode")
(use-package company-box :ensure t
(:hook (company-mode . company-box-mode))
Omnisharp and LSP
Omnisharp is actually a family of projects that implement various tooling and libraries to support .NET development, but what I liked the most is the omnisharp-emacs package which uses the Roslyn language server to provide "Intellisense" via the company frontend. However, in the last couple of years omnisharp has been deprecated in favour of Language Server Protocol to provide completion-at-point (CAPF) functions.
:init;; set prefix for lsp-command-keymap (few alternatives - "C-l", "C-c l")
setq lsp-keymap-prefix "C-c l")
:hook ((csharp-mode . lsp)lambda ()
(python-mode . (require 'lsp-python-ms)
:ensure :commands lsp-treemacs-errors-list)
That's pretty much all there is to it! Once you get lsp-mode installed it's necessary to install the actual server implementations on a per-language basis. For C# it's a no-brainer as there's only one (that I'm aware of) however for languages like python there are several competing language server implementations with various trade-offs so it's not always clear which one to use. The good news is that lsp-mode will auto-detect company-mode and friends, and furthermore will prompt you to install a language servers in scenarios where it cannot auto-install.
My complete emacs init file is not particularly sophisticated as I'm a bit of an emacs minimalist but it is available on github.