ILSpy

ILSpy é o navegador e descompilador de assemblies .NET de código aberto e multiplataforma. A interface de desktop é executada no Windows, Linux e macOS (construída sobre Avalonia).

Download: última versão | última build de CI (master) | Microsoft Store (apenas versões RTM)

Frontends do Descompilador

Além da interface de desktop multiplataforma ILSpy (disponível para download via Releases, consulte também plugins), os seguintes outros frontends estão disponíveis:

• Visual Studio 2022/2026 vêm com suporte a descompilação para F12 habilitado por padrão (usando nossos engines v8.2 e v9.1, respectivamente).
• Nossa extensão para Visual Studio 2022/2026 marketplace
• Nossa extensão para Visual Studio Code repositório | marketplace | open-vsx
• Nossa ferramenta dotnet para Linux/Mac/Windows - confira o ILSpyCmd neste repositório | dotnet tool install
• C# for Visual Studio Code também vem com suporte a descompilação. Para habilitar, ative a configuração "Enable Decompilation Support".
• Nossos pacotes NuGet ICSharpCode.Decompiler e ILSpyX para seus próprios projetos
• Nossos cmdlets PowerShell para Linux/Mac/Windows neste repositório

Recursos

• Descompilação para C# (confira o status de suporte à linguagem)
• Descompilação de projeto inteiro
• Abrir a partir de feed NuGet, abrir a partir de processo em execução, além de disco e GAC (somente Windows)
• Pesquisa por tipos/métodos/propriedades (saiba mais sobre as opções)
• Navegação por hiperlinks entre tipos/métodos/propriedades, favoritos
• Navegação por tipos base/derivados, histórico
• Explorador de metadados de assemblies (passo a passo do recurso)
• Descompilador BAML para XAML, suporte a !AvaloniaResources
• Suporte a binários ReadyToRun para .NET Core (veja o tutorial)
• Extensível via plugins
• Recursos adicionais em builds DEBUG (para os desenvolvedores)

Licença

ILSpy é distribuído sob a Licença MIT. Consulte o documento About para detalhes, bem como os avisos de terceiros para as bibliotecas de código aberto incluídas.

Como compilar

Windows:

• Certifique-se de que o PowerShell 7+ esteja instalado (o Windows PowerShell, pelo menos na versão 5.0, também funciona)
• Clone o repositório do ILSpy usando git.
• Execute git submodule update --init --recursive para baixar o submódulo ILSpy-Tests (usado por alguns casos de teste).
• Instale o Visual Studio (versão documentada: 18.0/2026). Você precisa dos seguintes componentes de carga de trabalho:
  • Carga de trabalho ".NET Desktop Development". Esta carga de trabalho inclui o SDK do .NET Framework 4.8 e o targeting pack do .NET Framework 4.7.2, bem como o SDK do .NET 10.0 (o ILSpy.csproj tem como alvo o .NET 10.0, mas também temos projetos net472). Nossos testes unitários exigem o SDK do .NET 11.0.
  • Carga de trabalho "Visual Studio extension development" (Observação: o ILSpy.VSExtensions.slnx é separado do ILSpy.slnx e, portanto, esta carga de trabalho é opcional)
  • Componente individual "MSVC v143 - VS 2022 C++ x64/x86 build tools" (ou similar)
    • O conjunto de ferramentas VC++ é opcional; se presente, ele é usado para editbin.exe modificar o tamanho da pilha usado pelo ILSpy.exe de 1MB para 16MB, porque o descompilador faz uso intenso de recursão, onde tamanhos de pilha pequenos levam a problemas em métodos muito complexos.
• Abra o ILSpy.slnx no Visual Studio.
  • A restauração de pacotes NuGet baixará automaticamente outras dependências
  • Execute o projeto "ILSpy" para a interface do ILSpy
  • Use o "Test Explorer" do Visual Studio para ver/executar os testes
  • Se você estiver interessado apenas em um subconjunto específico do ILSpy, também pode usar
    • ILSpy.Desktop.slnf: para a interface Avalonia multiplataforma e seus testes
    • ILSpy.XPlat.slnf: para a CLI multiplataforma (ilspycmd) ou cmdlets do PowerShell
    • ILSpy.VSExtensions.slnx: para as extensões do Visual Studio

Observação: O Visual Studio inclui uma versão do SDK do .NET que é gerenciada pelo instalador do Visual Studio - depois que você atualizar, ela também pode ser atualizada. Observe que o ILSpy é compatível apenas com o SDK do .NET 11.0 e o Visual Studio se recusará a carregar alguns projetos na solução (e os testes unitários falharão). Se esse problema ocorrer, instale manualmente o SDK do .NET 11.0 a partir daqui aqui.

Unix / Mac:

• Certifique-se de que o SDK do .NET 10.0 (para execução) e o SDK do .NET 11.0 (para testes) estejam instalados. Melhor ainda, use o dotnetup com o canal de SDK preview.
• Certifique-se de que o PowerShell esteja instalado (anteriormente conhecido como PowerShell Core)
• Clone o repositório usando git.
• Execute git submodule update --init --recursive para baixar o submódulo ILSpy-Tests (usado por alguns casos de teste).
• Use dotnet build ILSpy.Desktop.slnf para compilar a interface desktop Avalonia multiplataforma; execute-a com dotnet run --project ILSpy.
• Use dotnet build ILSpy.XPlat.slnf para compilar apenas a ferramenta CLI (ilspycmd) e os cmdlets do PowerShell.

Recomendamos o Visual Studio Code ou derivados junto com o DotRush, que também está disponível para derivados do VS Code.

Como contribuir