把.NET反编译搬进命令行：8个ILSpyCmd实战场景，让你彻底告别手工点界面

把.NET反编译搬进命令行8个ILSpyCmd实战场景让你彻底告别手工点界面【免费下载链接】ILSpy.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (more) - cross-platform!项目地址: https://gitcode.com/gh_mirrors/il/ILSpy接手一个只有编译产物、没有源码的.NET项目时多数人的第一反应是打开ILSpy图形界面在左侧树里一层层展开命名空间右键、复制、粘贴。而ILSpyCmd——ILSpy官方出品的命令行反编译工具能把反编译这件事压缩成一条命令并且可以写进脚本、接进CI让自动化反编译成为日常。本文用8个真实场景带你从零上手这个免费开源神器全程无需打开任何图形窗口。一个只有DLL的深夜反编译不该靠鼠标一格格点想象这个场景凌晨两点线上服务报错崩溃堆栈指向一个内部工具库而这个工具库的源码在离职同事的硬盘里公司唯一的副本只有build/目录下的那个.dll。你想看它内部到底干了什么于是打开反编译工具加载程序集展开几十个命名空间逐个双击类、右键另存……折腾半小时只拷出几个类文件而且格式还不一定对。如果反编译能变成一条命令这个场景会怎样ilspycmd -p -o ./recovered-src LegacyApp.dll几秒钟后./recovered-src里躺着完整的.csproj和按类型拆分的源码文件直接dotnet build就能编过。这就是ILSpyCmd存在的意义把图形界面里需要几十次点击的操作压成一条可复制、可脚本化、可进流水线的命令。ILSpyCmd 不是某个第三方魔改工具它是 ILSpy 官方维护的命令行前端与图形版共用同一套反编译引擎ICSharpCode.Decompiler跨平台运行Windows / Linux / macOS输出质量与你在 GUI 里看到的一致。核心入口在ICSharpCode.ILSpyCmd/IlspyCmdProgram.cs完整命令清单可随时用ilspycmd --help查看。如何在5分钟内完成第一次命令行反编译先确认环境里有 .NET SDK8.0 及以上然后装工具一条命令搞定dotnet tool install --global ilspycmd装完验证一下版本顺便看看有哪些选项ilspycmd --version ilspycmd --help第一次实战拿手头随便一个程序集练手# 不指定输出目录时反编译结果直接打印到终端 ilspycmd ./artifacts/LegacyApp.dll # 指定输出目录每个程序集生成一个 .cs 文件 ilspycmd -o ./recovered LegacyApp.dll到这里你已经完成了命令行反编译的第一次闭环输入一个 DLL得到可读的 C# 源码。接下来进入正题看看它真正值钱的能力。用一条命令把DLL还原成可编译的C#项目这是ILSpyCmd最常用的场景把程序集还原成可以直接编译的项目。加一个-p参数即可ilspycmd -p -o ./recovered-src LegacyApp.dll生成的目录结构是这样的一个.csproj项目文件目标框架、引用尽量还原每个类型一个.cs源文件命名空间与文件名对应程序集级的嵌入资源、引用信息一并还原如果类型很多、命名空间嵌套很深再加一个--nested-directories让目录结构跟着命名空间走看起来跟原始工程几乎一致ilspycmd -p -o ./recovered-src --nested-directories LegacyApp.dll还有个小惊喜当一次传入多个程序集时工具会顺手生成一个.sln解决方案文件把多个还原项目串在一起这个逻辑在IlspyCmdProgram.cs里由SolutionCreator负责ilspycmd -p -o ./recovered-src Core.dll Utils.dll LegacyApp.dll拿到手之后直接dotnet build一个能编译的旧系统就复活了——这正是做遗留系统重构的起点。如何只反编译某个类或方法而不是整个程序集整包反编译输出量大查一个类的时候很浪费。-t参数可以精确到类型# 只反编译指定的全限定类型 ilspycmd -t Contoso.Legacy.PaymentGateway LegacyApp.dll想先搞清楚程序集里到底有哪些类型用-l列出支持 c(类)、i(接口)、s(结构)、d(委托)、e(枚举) 的任意组合ilspycmd -l c,i,s LegacyApp.dll更细的粒度是定位到单个成员用-m传入 XML 文档 ID也就是summary注释里那种 ID 格式或者直接给元数据 token# 用文档 ID 定位到某个方法 ilspycmd -m M:Contoso.Legacy.PaymentGateway.Authorize(System.String) LegacyApp.dll # 或者用 token例如 0x06000005 ilspycmd -m 0x06000005 LegacyApp.dll这个能力特别适合排查单个方法的行为想查哪个方法就反编译哪个方法输出短、噪音小还能直接塞进 grep 管道继续分析。给第三方库生成PDB让断点落进还原出的源码第三方库报错时堆栈里全是xxx.dll!Namespace.Class.Method() 0x2a没有 PDB 就无法映射到行号调试基本靠猜。ILSpyCmd 可以直接为程序集生成可移植 PDBportable PDBilspycmd -genpdb -o ./pdbs LegacyApp.dll生成的.pdb与 DLL 放在一起Visual Studio / VS Code 就能把断点落到还原出来的源码上单步调试第三方库不再是梦。如果手头本来就有一份原始 PDB还能反过来利用它——反编译时让变量名直接沿用 PDB 里的信息代码可读性立刻上一个台阶# 从 PDB 中恢复变量名后再反编译 ilspycmd -usepdb ./pdbs/LegacyApp.pdb LegacyApp.dll顺带一提如果你的构建流程在发布时丢掉了 PDB完全可以把-genpdb挂到发布脚本里让可调试的第三方库成为交付物的一部分。用一条命令为遗留系统生成交互式架构图没有文档、没有架构图的老项目接手成本极高。ILSpyCmd 内置了一个 Mermaid 驱动的 HTML 架构图生成器实现位于ICSharpCode.ILSpyX/MermaidDiagrammer/一键产出可交互的类型关系图# 默认在程序集旁边生成 diagrammer 目录 ilspycmd LegacyApp.dll --generate-diagrammer # 输出到自定义目录并用正则过滤关心的类型范围 ilspycmd LegacyApp.dll --generate-diagrammer -o ./docs/diagram \ --generate-diagrammer-include Contoso\.Business\.. \ --generate-diagrammer-exclude Contoso\.Business\.Internal\..生成的 HTML 是单页应用直接扔给浏览器打开即可类与类之间的继承、实现、调用关系一目了然。如果你用--generate-diagrammer-report-excluded它还会输出一份哪些类型被过滤掉了、为什么的报告帮你反复打磨正则直到图表范围精确到想要的边界。想给图里的节点补充说明用--generate-diagrammer-docs指向程序集的 XML 文档注释文件即可。这套东西尤其适合技术文档编写、代码审查前的结构摸底、以及新人入职第一周的先看图再读码。批量反编译多个程序集并提取资源文件脚本场景里最爽的莫过于批量。多个程序集可以直接一起扔进去# 一次反编译三个程序集含通配符 ilspycmd -o ./batch-output Core.dll Utils.dll Plugins/*.dllWPF / WinForms 项目里常见的痛点还有资源文件。--list-resources可以把程序集内嵌的资源全部列出来包括.g.resources容器里的每个条目ilspycmd LegacyApp.dll --list-resources确定目标之后用--resource精确提取某一个。注意一个小细节如果资源名以.baml结尾工具会直接把二进制 BAML 反编译成可读的 XAML 输出而不是给你一堆乱码字节ilspycmd LegacyApp.dll --resource LegacyApp.g.resources/MainWindow.baml -o ./xaml-output想更彻底反编译项目时加上--decompile-baml所有 BAML 资源会作为 XAML Page 项还原到项目里WPF 程序的源码级还原直接一步到位ilspycmd -p -o ./recovered-src --decompile-baml LegacyApp.dll值得收藏的进阶参数IL代码、元数据表与语言版本反编译出 C# 之外ILSpyCmd 还有几个检查员级别的能力排查问题时常有奇效。想看方法真实的 IL 指令加-il想连 IL 序列点对应源码行号一起看用--il-sequence-pointsilspycmd -il LegacyApp.dll ilspycmd --il-sequence-points LegacyApp.dll想直接审查元数据--dump-table可以把 ECMA-335 元数据表整表导出TypeDef、Property、MethodSemantics 等大小写不敏感配合--json输出成结构化数据方便程序继续处理ilspycmd --dump-table TypeDef LegacyApp.dll ilspycmd --dump-table 0x17 --json LegacyApp.dll兼容老代码时输出语言版本也要可控-lv可以从 CSharp1 一路指定到 Preview / Latest让生成代码适配老编译器ilspycmd -lv CSharp8_0 -o ./compat-output LegacyApp.dll还有两个干净输出开关--no-dead-code剔除不可达代码、--no-dead-stores剔除死存储追求最小可读输出时值得一试。反编译时最容易踩的3个坑和绕行方案用过一段时间之后你会发现真正的坑就集中在几个地方提前绕开能省不少时间。坑一-p忘了带-o。项目模式强制要求输出目录这是参数校验规则见IlspyCmdProgram.cs上的ProjectOptionRequiresOutputDirectoryValidation。写脚本时先检查-o是否齐全否则直接报参数错误白白浪费一轮调试。坑二--json目前只认--dump-table。单独用--json会以错误码退出并提示仅支持与 --dump-table 搭配。想结构化输出反编译结果先导出元数据表 JSON再配合-t精确反编译目标类型两个命令组合使用。坑三自动化循环里被更新检查拖慢。工具每次运行默认会异步检查 NuGet 上是否有新版本网络请求在循环场景下既慢又不可控。在批量脚本、CI 流水线里一律加上--disable-updatecheckilspycmd --disable-updatecheck -o ./batch-output Plugins/*.dll另外提一句依赖问题反编译遇到类型解析不全时多半是依赖程序集不在搜索路径里用-r指定依赖目录如果个别程序集就是解析不了、又不想让整个脚本失败--ignore-decompilation-errors可以让退出码保持成功失败明细照样打到 stderr不影响流水线继续跑。把反编译接入CI文档与架构图自动更新手工反编译只能算用工具接进流水线才算自动化反编译。一个很常见的做法每次发布后自动重建还原源码和架构图让文档永远跟得上代码。下面这段脚本可以直接抄进发布流程#!/usr/bin/env bash # 发布后自动生成反编译源码与架构图 set -euo pipefail APPbin/Release/net8.0/LegacyApp.dll SRC_DIR./artifacts/decompiled DIAG_DIR./artifacts/diagrammer # 1. 还原可编译项目命名空间映射为目录 ilspycmd $APP -p -o $SRC_DIR --nested-directories --disable-updatecheck # 2. 生成过滤后的架构图只画业务层隐藏内部实现细节 ilspycmd $APP --generate-diagrammer -o $DIAG_DIR \ --generate-diagrammer-include Contoso\.Business\.. \ --generate-diagrammer-exclude Contoso\.Business\.Internal\.. \ --disable-updatecheck把这套脚本挂到 CI 的发布任务之后或在本地用一个定时任务驱动每次构建完artifacts/下就是最新的源码快照和架构图。团队里的新人、测试、甚至非技术同学都能直接打开 HTML 图看结构不再需要装任何反编译工具。也可以参考ICSharpCode.ILSpyCmd/README.md里关于 diagrammer 自动化生成的说明里面还有把图表部署到 Web 服务器上共享的做法。行动清单10分钟跑通你的第一个反编译流水线看完这么多场景真正动手只需三步装工具dotnet tool install --global ilspycmd然后ilspycmd --version确认安装成功。跑通最小闭环找一个手头的 DLL执行ilspycmd -o ./recovered YourApp.dll打开生成的.cs看一眼反编译质量。升级到项目模式执行ilspycmd -p -o ./recovered-src YourApp.dll如果一次传入多个程序集还能顺手收获一个.sln在脚本场景里记得补上--disable-updatecheck。想追源码、贡献补丁的话克隆 https://gitcode.com/gh_mirrors/il/ILSpy 自行构建重点看ICSharpCode.ILSpyCmd/目录。从深夜手点界面到一条命令进流水线差的只是一个命令行工具的使用习惯。ILSpyCmd 不改变反编译的精度但它改变了反编译发生的方式可重复、可追踪、可自动。下次再遇到没有源码的程序集别急着打开 GUI——先想想这条命令该怎么写。【免费下载链接】ILSpy.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (more) - cross-platform!项目地址: https://gitcode.com/gh_mirrors/il/ILSpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考