一文吃透 ILSpyCmd覆盖自动化反编译、批量处理与架构图生成的实操手册【免费下载链接】ILSpy.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (more) - cross-platform!项目地址: https://gitcode.com/gh_mirrors/il/ILSpy一个没有源码的 .NET 项目你要怎么接手想象一下这个场景公司交接给你一套老系统编译产物在源码却早就丢了或者你正在排查某个第三方库的诡异行为文档语焉不详唯一可靠的信息就是那几百个 dll。每次想确认一段逻辑都要在反编译工具里点来点去、手动复制代码、再回到 IDE 里比对——一次两次还行天天如此就成了体力活。如果你也遇到过这类看代码比写代码还累的时刻那么 ILSpyCmd 值得进入你的工具箱。它是 ILSpy 项目官方出品的命令行反编译工具专门解决自动化反编译的需求把程序集批量还原成 C# 源码、可编译工程、PDB 调试文件甚至生成交互式架构图。装上它之后反编译这件事就能从手工操作变成一条命令还能顺势塞进构建脚本和 CI 流水线。三步装好 ILSpyCmd跑通第一次反编译先确认环境再装工具最后跑一条最简命令整个过程三分钟。第一步确认 .NET SDK 可用ILSpyCmd 以 .NET Tool 形式分发依赖 SDK 才能运行dotnet --version能打印出版本号比如 8.0 或更高就说明环境没问题。第二步全局安装dotnet tool install --global ilspycmd安装完成后ilspycmd会直接注册为全局命令终端里随时可用。第三步跑通最小命令ilspycmd MyApp.dll这一步做了什么把整个程序集反编译成 C# 源码并打印到控制台。如果只想看代码、不想留下文件这一条就够了。想保存成文件加一个输出目录ilspycmd -o decompiled MyApp.dll会在decompiled目录下生成一个MyApp.decompiled.cs文件。到这里你的第一条自动化反编译命令已经跑通了。三个核心场景让反编译为你所用下面挑三个最常用的能力每个都用场景 → 命令 → 效果的方式走一遍。场景一把程序集还原成可编译工程接手遗留系统时你想要的不是一段段零散源码而是一个能整体打开、搜索、甚至重新编译的工程。ilspycmd -p -o src MyApp.dll这一步做了什么-p表示以可编译项目模式输出-o指定输出目录两者必须同时出现。命令结束后src目录下会生成MyApp.csproj和按类型拆分的源码文件。想让目录结构更接近你熟悉的工程布局再加上ilspycmd -p -o src --nested-directories MyApp.dll--nested-directories会让源码按命名空间分层存放而不是平铺在一层大型项目的阅读体验会好很多。场景二只反编译你关心的那一个类型一个动辄几万行的程序集全量反编译既慢又费眼。多数时候你只想确认某个类或某个方法的实现。先用列表命令摸清有哪些类型ilspycmd -l c,i,s MyApp.dll这一步做了什么-l后面可以组合 c类、i接口、s结构体、d委托、e枚举把指定类别的类型清单打印出来。看到目标类型的全名后定向反编译ilspycmd -t MyApp.Core.OrderParser MyApp.dll如果连方法级别都想精确到点可以用 XML 文档 ID 指定单个成员ilspycmd -m M:MyApp.Core.OrderParser.Parse(System.String) MyApp.dll效果输出里只有这一个方法的源码适合写代码评审意见或快速核对实现细节。场景三一键生成交互式架构图写技术文档或准备架构评审时与其手画类图不如让工具直接生成可交互的 HTML 图表ilspycmd MyApp.dll --generate-diagrammer这一步做了什么在程序集旁边的diagrammer目录里生成一份基于 Mermaid 的交互式 HTML包含类型关系、成员概览浏览器打开即可查看。程序集很大时用正则限定范围能显著提速ilspycmd MyApp.dll --generate-diagrammer \ --generate-diagrammer-include MyApp\.Core\.. \ --generate-diagrammer-exclude .\.Internal\..--generate-diagrammer-include做白名单、--generate-diagrammer-exclude做黑名单编译器自动生成的类型默认就会被过滤掉不用担心图表被噪音淹没。进阶组合参数把反编译变成流水线单个命令用熟之后就可以开始组合它们让自动化反编译真正跑起来。多程序集一次处理。ILSpyCmd 支持同时传入多个程序集配合-p会为每个程序集生成独立工程并额外写出一份解决方案文件ilspycmd -p -o decompiled App.Core.dll App.Utils.dll App.Cli.dll生成结果里既有三个.csproj也有一个.sln可以直接用 IDE 整体打开。脚本化批量处理。实际项目中把命令放进循环就是最简单的批处理for dll in bin/Release/*.dll; do ilspycmd --disable-updatecheck --ignore-decompilation-errors \ -p -o decompiled $dll done这段脚本里有两个容易被忽略、但自动化场景必备的参数--disable-updatecheck关闭启动时的联网更新检查在循环里它能省下可观的时间--ignore-decompilation-errors让部分代码反编译失败时不中断整个批次。为第三方库生成 PDB 再调试。库出问题时先生成调试文件再带着源码单步调试ilspycmd -genpdb ThirdParty.dll生成ThirdParty.pdb后配合--use-varnames-from-pdb反编译局部变量名会恢复成 PDB 里的原始命名可读性明显提升。对接 CI。想让架构图和文档随发布自动更新直接在项目文件里挂一个 Target 即可Target NameGenerateHtmlDiagrammer AfterTargetsPublish Exec Commandilspycmd $(TargetPath) --generate-diagrammer --outputdir $(PublishDir)diagrammer / /Target这样每次dotnet publish之后最新的架构图就会自动产出文档维护成本趋近于零。避坑指南这些报错和性能问题提前知道用了一段时间之后下面几个坑大概率会遇到提前了解能省不少排查时间。-p忘了带-o。项目模式必须指定输出目录否则直接报错。这属于最常见的用法错误看到提示补上-o即可。依赖解析失败。反编译依赖其他程序集的类型时如果解析不到引用会报错。可以用-r指向依赖所在的目录ilspycmd -r ./packages MyApp.dll-r可多次指定把散落在不同目录的依赖都加进去。类型名匹配歧义。简单的类名可能撞车此时工具会列出候选并拒绝猜测。解决办法是使用完整反射名泛型类型记得带上 arity 后缀例如MyApp.Cache\1。退出码不总是 0。默认情况下只要有一部分代码反编译失败进程就会以非零状态退出错误详情同时写入 stderr 和源码占位处。这在脚本里容易被误判为整个任务失败如果希望尽力而为就用--ignore-decompilation-errors。大程序集生成架构图慢、文件大。Mermaid 渲染有输入大小上限图太大时可能渲染失败。对策是先用--generate-diagrammer-include/--generate-diagrammer-exclude把范围收窄到某个子域必要时为不同子域生成多张图并用--generate-diagrammer-report-excluded校验正则写对了没有。实战小结什么时候用哪条命令最后把常用诉求和对应命令整理成一张速查表遇到问题直接对照你的诉求命令要点快速浏览某个 dll 的源码ilspycmd app.dll还原成可编译工程-p -o src可加--nested-directories只查一个类型 / 一个方法-t 类型全名/-m 文档ID摸清程序集有哪些类型-l c,i,s,d,e生成 PDB 辅助调试-genpdb反编译时加--use-varnames-from-pdb生成架构图--generate-diagrammer 正则过滤批量反编译多个程序集多个 dll 并列 -p -o得到多个工程和一个 sln塞进 CI / 脚本加--disable-updatecheck与--ignore-decompilation-errors从临时看一眼代码到定时批量产出工程与文档ILSpyCmd 的价值在于把反编译从手工劳动变成了可复用的自动化能力。如果你的场景更进一步——比如要提取嵌入资源--list-resources/--resource或导出元数据表--dump-table这些参数官方文档里都有完整说明遇到新需求时不妨先翻一遍帮助信息ilspycmd --help会列出全部选项与示例。延伸阅读官方命令说明见 ICSharpCode.ILSpyCmd/README.md完整参数实现可参考 ICSharpCode.ILSpyCmd/IlspyCmdProgram.cs。如果想从源码构建最新版可以执行git clone https://gitcode.com/gh_mirrors/il/ILSpy后自行编译。【免费下载链接】ILSpy.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (more) - cross-platform!项目地址: https://gitcode.com/gh_mirrors/il/ILSpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一文吃透 ILSpyCmd：覆盖自动化反编译、批量处理与架构图生成的实操手册
一文吃透 ILSpyCmd覆盖自动化反编译、批量处理与架构图生成的实操手册【免费下载链接】ILSpy.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (more) - cross-platform!项目地址: https://gitcode.com/gh_mirrors/il/ILSpy一个没有源码的 .NET 项目你要怎么接手想象一下这个场景公司交接给你一套老系统编译产物在源码却早就丢了或者你正在排查某个第三方库的诡异行为文档语焉不详唯一可靠的信息就是那几百个 dll。每次想确认一段逻辑都要在反编译工具里点来点去、手动复制代码、再回到 IDE 里比对——一次两次还行天天如此就成了体力活。如果你也遇到过这类看代码比写代码还累的时刻那么 ILSpyCmd 值得进入你的工具箱。它是 ILSpy 项目官方出品的命令行反编译工具专门解决自动化反编译的需求把程序集批量还原成 C# 源码、可编译工程、PDB 调试文件甚至生成交互式架构图。装上它之后反编译这件事就能从手工操作变成一条命令还能顺势塞进构建脚本和 CI 流水线。三步装好 ILSpyCmd跑通第一次反编译先确认环境再装工具最后跑一条最简命令整个过程三分钟。第一步确认 .NET SDK 可用ILSpyCmd 以 .NET Tool 形式分发依赖 SDK 才能运行dotnet --version能打印出版本号比如 8.0 或更高就说明环境没问题。第二步全局安装dotnet tool install --global ilspycmd安装完成后ilspycmd会直接注册为全局命令终端里随时可用。第三步跑通最小命令ilspycmd MyApp.dll这一步做了什么把整个程序集反编译成 C# 源码并打印到控制台。如果只想看代码、不想留下文件这一条就够了。想保存成文件加一个输出目录ilspycmd -o decompiled MyApp.dll会在decompiled目录下生成一个MyApp.decompiled.cs文件。到这里你的第一条自动化反编译命令已经跑通了。三个核心场景让反编译为你所用下面挑三个最常用的能力每个都用场景 → 命令 → 效果的方式走一遍。场景一把程序集还原成可编译工程接手遗留系统时你想要的不是一段段零散源码而是一个能整体打开、搜索、甚至重新编译的工程。ilspycmd -p -o src MyApp.dll这一步做了什么-p表示以可编译项目模式输出-o指定输出目录两者必须同时出现。命令结束后src目录下会生成MyApp.csproj和按类型拆分的源码文件。想让目录结构更接近你熟悉的工程布局再加上ilspycmd -p -o src --nested-directories MyApp.dll--nested-directories会让源码按命名空间分层存放而不是平铺在一层大型项目的阅读体验会好很多。场景二只反编译你关心的那一个类型一个动辄几万行的程序集全量反编译既慢又费眼。多数时候你只想确认某个类或某个方法的实现。先用列表命令摸清有哪些类型ilspycmd -l c,i,s MyApp.dll这一步做了什么-l后面可以组合 c类、i接口、s结构体、d委托、e枚举把指定类别的类型清单打印出来。看到目标类型的全名后定向反编译ilspycmd -t MyApp.Core.OrderParser MyApp.dll如果连方法级别都想精确到点可以用 XML 文档 ID 指定单个成员ilspycmd -m M:MyApp.Core.OrderParser.Parse(System.String) MyApp.dll效果输出里只有这一个方法的源码适合写代码评审意见或快速核对实现细节。场景三一键生成交互式架构图写技术文档或准备架构评审时与其手画类图不如让工具直接生成可交互的 HTML 图表ilspycmd MyApp.dll --generate-diagrammer这一步做了什么在程序集旁边的diagrammer目录里生成一份基于 Mermaid 的交互式 HTML包含类型关系、成员概览浏览器打开即可查看。程序集很大时用正则限定范围能显著提速ilspycmd MyApp.dll --generate-diagrammer \ --generate-diagrammer-include MyApp\.Core\.. \ --generate-diagrammer-exclude .\.Internal\..--generate-diagrammer-include做白名单、--generate-diagrammer-exclude做黑名单编译器自动生成的类型默认就会被过滤掉不用担心图表被噪音淹没。进阶组合参数把反编译变成流水线单个命令用熟之后就可以开始组合它们让自动化反编译真正跑起来。多程序集一次处理。ILSpyCmd 支持同时传入多个程序集配合-p会为每个程序集生成独立工程并额外写出一份解决方案文件ilspycmd -p -o decompiled App.Core.dll App.Utils.dll App.Cli.dll生成结果里既有三个.csproj也有一个.sln可以直接用 IDE 整体打开。脚本化批量处理。实际项目中把命令放进循环就是最简单的批处理for dll in bin/Release/*.dll; do ilspycmd --disable-updatecheck --ignore-decompilation-errors \ -p -o decompiled $dll done这段脚本里有两个容易被忽略、但自动化场景必备的参数--disable-updatecheck关闭启动时的联网更新检查在循环里它能省下可观的时间--ignore-decompilation-errors让部分代码反编译失败时不中断整个批次。为第三方库生成 PDB 再调试。库出问题时先生成调试文件再带着源码单步调试ilspycmd -genpdb ThirdParty.dll生成ThirdParty.pdb后配合--use-varnames-from-pdb反编译局部变量名会恢复成 PDB 里的原始命名可读性明显提升。对接 CI。想让架构图和文档随发布自动更新直接在项目文件里挂一个 Target 即可Target NameGenerateHtmlDiagrammer AfterTargetsPublish Exec Commandilspycmd $(TargetPath) --generate-diagrammer --outputdir $(PublishDir)diagrammer / /Target这样每次dotnet publish之后最新的架构图就会自动产出文档维护成本趋近于零。避坑指南这些报错和性能问题提前知道用了一段时间之后下面几个坑大概率会遇到提前了解能省不少排查时间。-p忘了带-o。项目模式必须指定输出目录否则直接报错。这属于最常见的用法错误看到提示补上-o即可。依赖解析失败。反编译依赖其他程序集的类型时如果解析不到引用会报错。可以用-r指向依赖所在的目录ilspycmd -r ./packages MyApp.dll-r可多次指定把散落在不同目录的依赖都加进去。类型名匹配歧义。简单的类名可能撞车此时工具会列出候选并拒绝猜测。解决办法是使用完整反射名泛型类型记得带上 arity 后缀例如MyApp.Cache\1。退出码不总是 0。默认情况下只要有一部分代码反编译失败进程就会以非零状态退出错误详情同时写入 stderr 和源码占位处。这在脚本里容易被误判为整个任务失败如果希望尽力而为就用--ignore-decompilation-errors。大程序集生成架构图慢、文件大。Mermaid 渲染有输入大小上限图太大时可能渲染失败。对策是先用--generate-diagrammer-include/--generate-diagrammer-exclude把范围收窄到某个子域必要时为不同子域生成多张图并用--generate-diagrammer-report-excluded校验正则写对了没有。实战小结什么时候用哪条命令最后把常用诉求和对应命令整理成一张速查表遇到问题直接对照你的诉求命令要点快速浏览某个 dll 的源码ilspycmd app.dll还原成可编译工程-p -o src可加--nested-directories只查一个类型 / 一个方法-t 类型全名/-m 文档ID摸清程序集有哪些类型-l c,i,s,d,e生成 PDB 辅助调试-genpdb反编译时加--use-varnames-from-pdb生成架构图--generate-diagrammer 正则过滤批量反编译多个程序集多个 dll 并列 -p -o得到多个工程和一个 sln塞进 CI / 脚本加--disable-updatecheck与--ignore-decompilation-errors从临时看一眼代码到定时批量产出工程与文档ILSpyCmd 的价值在于把反编译从手工劳动变成了可复用的自动化能力。如果你的场景更进一步——比如要提取嵌入资源--list-resources/--resource或导出元数据表--dump-table这些参数官方文档里都有完整说明遇到新需求时不妨先翻一遍帮助信息ilspycmd --help会列出全部选项与示例。延伸阅读官方命令说明见 ICSharpCode.ILSpyCmd/README.md完整参数实现可参考 ICSharpCode.ILSpyCmd/IlspyCmdProgram.cs。如果想从源码构建最新版可以执行git clone https://gitcode.com/gh_mirrors/il/ILSpy后自行编译。【免费下载链接】ILSpy.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (more) - cross-platform!项目地址: https://gitcode.com/gh_mirrors/il/ILSpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考