ILSpy

ILSpy ist der quelloffene, plattformübergreifende .NET-Assembly-Browser und Decompiler. Die Desktop-Oberfläche läuft unter Windows, Linux und macOS (basiert auf Avalonia).

Download: neueste Version | neuester CI-Build (master) | Microsoft Store (nur RTM-Versionen)

Decompiler-Frontends

Neben der plattformübergreifenden Desktop-Oberfläche ILSpy (herunterladbar über Releases, siehe auch Plugins) sind die folgenden weiteren Frontends verfügbar:

• Visual Studio 2022/2026 wird mit standardmäßig aktivierter Dekompilierungsunterstützung für F12 ausgeliefert (unter Verwendung unserer Engines v8.2 bzw. v9.1).
• Unsere Visual Studio 2022/2026-Erweiterung Marketplace
• Unsere Visual Studio Code-Erweiterung Repository | Marketplace | open-vsx
• Unser dotnet-Tool für Linux/Mac/Windows – siehe ILSpyCmd in diesem Repository | dotnet tool install
• C# for Visual Studio Code wird ebenfalls mit Dekompilierungsunterstützung ausgeliefert. Zur Aktivierung die Einstellung „Enable Decompilation Support“ aktivieren.
• Unsere NuGet-Pakete ICSharpCode.Decompiler und ILSpyX für eigene Projekte
• Unsere PowerShell-Cmdlets für Linux/Mac/Windows in diesem Repository

Funktionen

• Dekompilierung nach C# (siehe den Status der Sprachunterstützung)
• Dekompilierung ganzer Projekte
• Öffnen aus NuGet-Feed, Öffnen aus laufendem Prozess zusätzlich zu Datenträger und GAC (nur Windows)
• Suche nach Typen/Methoden/Eigenschaften (mehr zu den Optionen)
• Hyperlink-basierte Navigation zu Typen/Methoden/Eigenschaften, Lesezeichen
• Navigation zu Basis-/abgeleiteten Typen, Verlauf
• Assembly-Metadaten-Explorer (Funktionsübersicht)
• BAML-zu-XAML-Decompiler, !AvaloniaResources-Unterstützung
• ReadyToRun-Binärdateiunterstützung für .NET Core (siehe das Tutorial)
• Erweiterbar über Plugins
• Zusätzliche Funktionen in DEBUG-Builds (für die Entwickler)

Lizenz

ILSpy wird unter der MIT-Lizenz vertrieben. Details finden Sie im About-Dokument sowie in den Hinweisen zu Drittanbietern für enthaltene Open-Source-Bibliotheken.

So wird gebaut

Windows:

• Stelle sicher, dass PowerShell 7+ installiert ist (Windows PowerShell ab Version 5.0 funktioniert ebenfalls)
• Klone das ILSpy-Repository mit git.
• Führe git submodule update --init --recursive aus, um das ILSpy-Tests-Submodul herunterzuladen (wird von einigen Testfällen verwendet).
• Installiere Visual Studio (dokumentierte Version: 18.0/2026). Du benötigst die folgenden Workload-Komponenten:
  • Workload „.NET Desktop Development“. Dieser Workload enthält das .NET Framework 4.8 SDK und das .NET Framework 4.7.2 Targeting Pack sowie das .NET 10.0 SDK (ILSpy.csproj zielt auf .NET 10.0 ab, aber wir haben auch net472-Projekte). Unsere Unit-Tests erfordern das .NET 11.0 SDK.
  • Workload „Visual Studio extension development“ (Hinweis: ILSpy.VSExtensions.slnx ist von ILSpy.slnx getrennt, daher ist dieser Workload optional)
  • Einzelne Komponente „MSVC v143 - VS 2022 C++ x64/x86 build tools“ (oder ähnlich)
    • Das VC++-Toolset ist optional; falls vorhanden, wird es für editbin.exe verwendet, um die von ILSpy.exe genutzte Stackgröße von 1 MB auf 16 MB zu ändern, da der Decompiler stark auf Rekursion setzt, wobei kleine Stackgrößen bei sehr komplexen Methoden zu Problemen führen.
• Öffne ILSpy.slnx in Visual Studio.
  • Die NuGet-Paketwiederherstellung lädt weitere Abhängigkeiten automatisch herunter
  • Führe das Projekt „ILSpy“ für die ILSpy-Benutzeroberfläche aus
  • Verwende den Visual Studio „Test Explorer“, um die Tests anzuzeigen/auszuführen
  • Wenn du nur an einer bestimmten Teilmenge von ILSpy interessiert bist, kannst du auch Folgendes verwenden:
    • ILSpy.Desktop.slnf: für die plattformübergreifende Avalonia-Benutzeroberfläche und ihre Tests
    • ILSpy.XPlat.slnf: für die plattformübergreifende CLI (ilspycmd) oder PowerShell-Cmdlets
    • ILSpy.VSExtensions.slnx: für die Visual Studio-Erweiterungen

Hinweis: Visual Studio enthält eine Version des .NET SDK, die vom Visual Studio Installer verwaltet wird – sobald du ein Update durchführst, kann sie ebenfalls aktualisiert werden. Bitte beachte, dass ILSpy nur mit dem .NET 11.0 SDK kompatibel ist und Visual Studio sich weigern wird, einige Projekte in der Lösung zu laden (und Unit-Tests werden fehlschlagen). Wenn dieses Problem auftritt, installiere bitte das .NET 11.0 SDK manuell von hier.

Unix / Mac:

• Stelle sicher, dass das .NET 10.0 SDK (zum Ausführen) und das .NET 11.0 SDK (für Tests) installiert sind. Besser noch: Verwende dotnetup mit dem SDK-Kanal „preview“.
• Stelle sicher, dass PowerShell installiert ist (früher bekannt als PowerShell Core)
• Klone das Repository mit git.
• Führe git submodule update --init --recursive aus, um das ILSpy-Tests-Submodul herunterzuladen (wird von einigen Testfällen verwendet).
• Verwende dotnet build ILSpy.Desktop.slnf, um die plattformübergreifende Avalonia-Desktop-Benutzeroberfläche zu erstellen; führe sie mit dotnet run --project ILSpy aus.
• Verwende dotnet build ILSpy.XPlat.slnf, um nur das CLI-Tool (ilspycmd) und die PowerShell-Cmdlets zu erstellen.

Wir empfehlen Visual Studio Code oder Derivate zusammen mit DotRush, das auch für Derivate von VS Code verfügbar ist.