C# Development Environment for Visual Studio Code

DotRush is a powerful, lightweight, and efficient C# Development Environment designed for VS Code. Built with performance and simplicity in mind, DotRush provides a seamless development experience for C# developers.

Overview

C# IntelliSense Roslyn-based autocompletion, suggestions, and code navigation to help you write code faster.
.NET Core Debugger Debug your C# applications with the built-in .NET Core Debugger.
.NET Core Profiler Profile your .NET Core applications with the built-in profiler tools.
Unity Debugger Debug your Unity projects with the integrated Mono Debugger.
Test Explorer Run and debug your unit tests with the integrated Test Explorer.
Code Decompilation Instantly decompile code with ICSharpCode Decompiler to view the underlying source.
Multitarget Diagnostics Real-time linting and error detection to catch issues early in all target frameworks of your project.
Multi-platform Support Seamless integration with both VS Code and NeoVim on Windows, macOS, and Linux.
Performance Lightweight and efficient, DotRush is designed to be fast and responsive.

Working with Projects and Solutions

If your folder contains multiple projects or a solution file, DotRush will show the following picker for all projects and solutions in the folder. DotRush automatically saves selected projects and solutions in the workspace settings. You can open it manually by executing the DotRush: Pick Project or Solution files command:

Running and Debugging .NET Core Applications

To run and debug your .NET Core applications, you can use the built-in .NET Core Debugger. You can start debugging by pressing F5 and select the .NET Core Debugger configuration. You can also create a launch.json file with the following content:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Debugger (launch)",
            "type": "coreclr",
            "request": "launch",
            "program": "${command:dotrush.activeTargetPath}",
            "preLaunchTask": "dotrush: Build"
        },
        {
            "name": ".NET Core Debugger (attach)",
            "type": "coreclr",
            "request": "attach",
            "processId": "${command:dotrush.pickProcess}"
        }
    ]
}

You can change the startup project by clicking on it and executing the Set as Startup Project command from the context menu. You can also change the debugger options in the VSCode settings.

Running and Debugging NUnit / xUnit / MSTest Tests

To run and debug your VSTest tests, you can use the integrated Test Explorer in VSCode. Run test by clicking on the run button next to the test or debug it by right-clicking on the run button and selecting the Debug Test option in the context menu.

Debugging Unity Projects

To debug your Unity project, you can use the integrated Mono Debugger. Open the Unity project in VSCode (for example, by opening it from the Unity Editor) and start debugging by pressing F5 and select the Unity Debugger configuration. You can also create a launch.json file with the following content:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Unity Debugger",
            "type": "unity",
            // Attach to Android device
            // "transportArgs": {
            //     "type": "android"
            // },
            "request": "attach"
        }
    ]
}

You can change the debugger options in the VSCode settings.

Debugging Godot Projects

To debug your Godot project, open it in VSCode and create a launch.json file with the following content (adjust the processPath to the location of your Godot Engine executable):

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Debugger (attach)",
            "type": "coreclr",
            "request": "attach",
            "processPath": "C:\\Programs\\Godot\\Godot_v4.4.1-stable_mono_win64.exe",
            "preLaunchTask": "dotrush: Build"
        }
    ]
}

Press F5 to start debugging. It will launch the Godot Engine and attach the debugger to it:

Profiling .NET Core Applications

To profile your .NET Core applications, you can use the built-in dotnet-trace and dotnet-gcdump tools. You can attach the profiler to a running process by executing the DotRush: Attach Trace Profiler or DotRush: Create Heap Dump commands. Also you can use the following buttons in the debugger toolbar if you have the .NET Core Debugger running:

For the trace report, you can use the Speedscope in VSCode extension to view it. Alternatively, you can upload it directly to the speedscope site.
For the gcdump report, you can use the dotnet-heapview or Visual Studio for Windows.

Limitations

DotRush currently supports only C# language features and does not support Razor, XAML, or other languages. Also it does not support the following language features:

CodeLens DotRush does not support CodeLens features such as references, tests, and other CodeLens features.

Alternative Editors

You can also use DotRush with other editors. See the following readme files for more information.

DotRush

Install / Use

README