A .NET server-side implementation of Language Server Protocol infrastructure library for VSCode, and hopefully, might also be used with other IDEs that support Language Server Protocol. It provides necessary data structure used for JSON serialization and JSON RPC calls for LSP 3.6 and up.
The library is now available on NuGet. To install the package, run the following command
# Package Manager Console Install-Package CXuesong.LanguageServer.VsCode -Pre # dotnet CLI dotnet add package CXuesong.LanguageServer.VsCode -Pre
If you found any missing data structures, please open an issue in this repository.
Based on CXuesong/JsonRpc.Standard, this .NET Standard library intends to provide basic interfaces and data structures so that you can write a language server in C#, build it on .NET Core and, with the help of the client-side code of Microsoft/vscode-languageserver-node, use it in VSCode.
To set up the demo
- .NET Core SDK 3.1
- (Optionally) Visual Studio 2019
- yarn (or npm)
DemoLanguageServerin VS, choose
Debugprofile, and build the project.
- Alternatively, run
- Alternatively, run
Client\VsCodefolder in VSCode.
yarn installin the terminal.
- Press F5 and a new VSCode window (Extension Development Host) should show.
- Open a folder in the new VSCode window, and create a new file.
- Change the file language to
- Then your editor will work as shown in the screenshot. Enter
.net corein the editor and see what happens.
To debug the server application, you may wish to turn
WAIT_FOR_DEBUGGER conditional switch on in
DemoLanguageServer/Program.cs. After starting up the Extension Development Host, and activating the language server, you may attach VS Debugger to
dotnet process and go on debugging.
You may also set the
default value of
package.json to make language client show more debugging information.
- Though it's not mentioned in MS's official LSP documentation, by default VsCode uses stdin/stdout as JSON RPC transportation channel; thus it's important you SHOULD NOT read from/write to the console from your own code as long as the connection has been established, to avoid interfering the JSON RPC communication.
- If you are using the LSP client library from
vscode-languageserver-node, other transportation channels, such as named pipe (Windows) or Unix domain socket (Linux/MacOS) is possible via client-side configuration; though you will need to write your own server-side implementation.
- It's worthwhile to be noted that Unix domain socket has been introduced since Windows 10 Build 17063. However, there is currently no means to set up a Unix domain socket client in Node.JS on Windows. Thus it seems that, up till now, we still cannot use Unix domain socket as JSON RPC as transportation channel on Windows. See the tracking issue: CXuesong/JsonRpc.Standard#4.