没有源码也能救场ILSpyCmd 命令行反编译的 8 个实战场景【免费下载链接】ILSpy.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (more) - cross-platform!项目地址: https://gitcode.com/gh_mirrors/il/ILSpy先把结论放在前面ILSpyCmd 是 ILSpy 项目自带的命令行反编译工具安装后一条命令就能把 DLL 还原成可读的 C# 代码还能生成可编译工程、PDB 调试文件甚至交互式架构图。这篇文章不讲干巴巴的参数表而是按 8 个真实场景展开帮你快速判断哪种处境该用哪个命令、坑在哪里。凌晨两点你面前摆着一个没有源码的黑盒几乎每个 .NET 开发者都遇到过这样的时刻接手一个遗留项目源码早就失传只剩一堆编译好的 DLL第三方库出了诡异 bug文档语焉不详只能自己扒代码同事离职时留下一个能跑但没人看得懂的模块没人敢动它。面对这些情况过去我们只能打开图形界面的反编译软件点半天菜单再把结果一段段复制出来。而 ILSpyCmd 的思路完全不同——它把反编译变成了一条可在终端里随时调用、也能写进脚本的命令。这就像别人给你一把钥匙你既能在门口试试也能把它配进自动化的大门里。第一次见面一条命令装好十秒跑通安装过程简单到不需要思考.NET 开发者用 CLI 工具即可dotnet tool install --global ilspycmd装完就能用。最简单的反编译只需要指定一个程序集结果直接打印到终端ilspycmd sample.dll输出太多看不过来加一个-o指定输出目录它会把结果写进文件而不是刷屏ilspycmd -o ./decompiled sample.dll到这一步你已经完成了从二进制到源码的第一步。接下来才是重头戏。场景一只想盯住一个类别把整个程序集都倒出来现实中的程序集动辄几千个类全量反编译既慢又难读。当你只想搞懂某个类的实现时用-t指定完全限定名ilspycmd -t Your.Namespace.ClassName sample.dll如果连类都不需要只想看某个方法的逻辑用-m加上 XML 文档 ID 或元数据 tokenilspycmd -m M:System.String.Concat(System.String,System.String) sample.dll适用场景定位某个具体 bug、对比两个版本间的行为差异。与其把整座图书馆搬回家不如只借一本书。场景二C# 里看不出的细节直接下潜到 IL反编译出来的 C# 偶尔会失真——比如某些内联优化、异常的异常处理结构。这时候需要看到最底层的中间语言也就是 ILilspycmd --ilcode sample.dll想连调试时命中的源码位置一起看用--il-sequence-points它会自动带上--ilcode。适用场景排查栈溢出、验证编译器优化是否符合预期、研究某个库到底在底层做了什么。C# 是翻译后的文章IL 是原文有些真相只有原文里才有。场景三把黑盒变回一个能编译的工程只读代码还不够很多时候你希望直接改完重新编译。-p参数会生成完整的工程文件.csproj每个类型一个源文件就像从源码仓库里拉下来的一样ilspycmd -p -o ./decompiled sample.dll注意-p必须搭配-o否则它会直接报错提醒你。项目体量大时加上--nested-directories让目录按命名空间分层结构更清爽ilspycmd --nested-directories -p -o ./decompiled sample.dll如果程序集里带 WPF 界面还能用--decompile-baml把二进制界面资源还原成 XAML 源码而不是一堆字节流。适用场景遗留系统重建、给老项目补测试、把第三方组件改造进自己的产品线。场景四调试第三方库之前先补一张调试地图没有 PDB 文件断点根本进不了第三方库的源码。ILSpyCmd 可以反过来生成 portable PDBilspycmd --generate-pdb sample.dll反过来如果你手里恰好有一份旧的 PDB想让反编译结果里的变量名更接近原始代码用-usepdb读取它ilspycmd -usepdb sample.pdb sample.dll适用场景调试第三方库、分析线上崩溃转储。有了这张地图调试器就能带你在陌生的代码里自由行走。场景五文档和代码脱节让架构图自己长出来写架构文档最痛苦的不是画图而是图永远赶不上代码的变化。--generate-diagrammer会基于程序集中的类型关系生成一份交互式 HTML 架构图ilspycmd sample.dll --generate-diagrammer默认输出在与程序集同级的diagrammer文件夹。类型太多时用正则白名单和黑名单控制范围ilspycmd sample.dll --generate-diagrammer \ --generate-diagrammer-include Your\.Models\.. \ --generate-diagrammer-exclude .\Metadata适用场景代码审查前的架构梳理、新人入职指引、技术方案评审材料。让文档跟着发布流程自动更新而不是靠某个人记得去维护。场景六资源文件里也藏着不少秘密程序集里嵌入的资源往往被人忽视但它们可能包含图标、配置、甚至完整的 XAML 界面。先列出清单ilspycmd --list-resources sample.dll然后按名字提取单个资源。名字以.baml结尾的会自动还原成 XAML其余按原始字节输出ilspycmd --resource sample.g.resources/mainwindow.baml -o ./decompiled sample.dll适用场景找回丢失的设计稿、确认某个配置是否被打进了包、审计程序集里到底塞了什么私货。场景七把反编译挂进 CI文档从此自动更新ILSpyCmd 的价值在自动化场景里最能放大。比如让每次发布后自动重新生成架构图只需要在工程文件里加一个 MSBuild TargetTarget NameGenerateHtmlDiagrammer AfterTargetsPublish Exec Commandilspycmd $(TargetPath) --generate-diagrammer --outputdir $(PublishDir)diagrammer / /Target在完全自动化的流水线里建议加上--disable-updatecheck关掉更新检查避免每次调用都去做网络请求拖慢流程。适用场景持续集成、批量脚本处理、夜间文档任务。场景八给程序集做一次全身体检反编译之外ILSpyCmd 还能当诊断工具用。--dump-table可以导出任意 ECMA-335 元数据表的原始内容配合--json输出结构化结果ilspycmd --dump-table TypeDef --json sample.dll想快速摸清程序集的组成用-l列出各类实体c类、i接口、s结构体、d委托、e枚举想拿到内部打包的子程序集用-d一键解包。适用场景安全审计、格式分析、写自动化测试前的摸底。多程序集可以一次全给命令会自动逐个处理ilspycmd assembly1.dll assembly2.dll assembly3.exe给新手的避坑提示踩过的坑写下来帮你少走弯路-p忘了带-o会直接报错这不是 bug是设计——它不想让你把工程文件洒得到处都是。反编译结果依赖引用程序集。缺依赖时用-r指定引用目录个别类型反编译失败可以加--ignore-decompilation-errors让它能出多少出多少失败信息仍会列在 stderr。架构图别贪大。几千个类型一次性全画构建慢、文件大、浏览器也卡。先用 ILSpy 图形界面摸清结构再用--generate-diagrammer-include缩小范围分领域生成多张图效果更好。想要最新版本直接跑dotnet tool update --global ilspycmd想从源码自己构建clone 下来编译ICSharpCode.ILSpyCmd工程即可仓库地址git clone https://gitcode.com/gh_mirrors/il/ILSpy。写在最后回到开头的那个凌晨接盘老项目也好排查第三方库也好ILSpyCmd 的意义在于——它把反编译从一次性的手工操作变成了一条随时可调用、可重复、可自动化的命令。完整的命令说明可以查阅项目内的 ICSharpCode.ILSpyCmd/README.md所有参数的定义都在 ICSharpCode.ILSpyCmd/IlspyCmdProgram.cs 里架构图生成器的实现则在 ICSharpCode.ILSpyX/MermaidDiagrammer/。下次再遇到没源码的局面先别慌。打开终端敲下ilspycmd让代码自己开口说话。【免费下载链接】ILSpy.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (more) - cross-platform!项目地址: https://gitcode.com/gh_mirrors/il/ILSpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考