roslyn.nvim

# roslyn.nvim

This is an actively maintained & upgraded [fork](https://github.com/jmederosalvarado/roslyn.nvim) that interacts with the improved & open-source C# [Roslyn](https://github.com/dotnet/roslyn) language server, meant to replace the old and discontinued OmniSharp. This language server is currently used in the [Visual Studio Code C# Extension](https://github.com/dotnet/vscode-csharp), which is shipped with the standard C# Dev Kit.

## Razor/CSHTML Support

This plugin has recently added support for Razor/CSHTML files. This enabled
razor support using co-hosting and superceeds the old
[rzls.nvim](https://github.com/tris203/rzls.nvim).

If you previoulsy used `rzls.nvim`, please uninstall it and the `rzls` language
server.

## ⚡️ Requirements

- Neovim >= 0.12.0
- Roslyn language server >= `5.12.0-1.26453.19` downloaded locally
- .NET SDK installed and `dotnet` command available

## Difference to nvim-lspconfig

`roslyn` is now a part of [nvim-lspconfig], but it does not implement all things that are implemented here.  
This plugin tries to keep things minimal but still implement some things that is not suited for [nvim-lspconfig].  
A couple of additional things this plugin implements

- Support for multiple solutions
- Broad root_dir detection support. Meaning it will search for solutions upward in parent directories if `broad_search` option is set
- Support for source generated files
- `Roslyn target` command to switch between multiple solutions
- Running and debugging tests through the server

## Demo

https://github.com/user-attachments/assets/a749f6c7-fc87-440c-912d-666d86453bc5

## 📦 Installation

<details>
  <summary>Mason (recommended)</summary>

You can install with `MasonInstall roslyn-language-server`. Note that this is installing it from [nuget.org] which is not necessarily up to date with the same version used in vscode.

For the time being, I would recommend using a custom registry to get a more up to date version.
For this, you need to use a custom mason registry and set it up like this.

```lua
require("mason").setup({
    registries = {
        "github:mason-org/mason-registry",
        "github:Crashdummyy/mason-registry",
    },
})
```

This registry provides two versions:
- `roslyn` (same version as in vscode)
- `roslyn-nightly` (bleeding edge features with potentially breaking changes)

</details>

<details>
  <summary>Manually</summary>

  Requires .NET 10 or later. Install the latest development build from Microsoft's [Azure DevOps feed] (recommended):

  ```bash
  dotnet tool install -g roslyn-language-server --prerelease --source https://pkgs.dev.azure.com/azure-public/vside/_packaging/vs-impl/nuget/v3/index.json
  ```

  Or install from [nuget.org], which is updated less frequently:

  ```bash
  dotnet tool install -g roslyn-language-server --prerelease
  ```

  To update, replace `install` with `update`. To pin a build, replace `--prerelease` with `--version <version>`.

  Ensure `~/.dotnet/tools` (Linux/macOS)