AsmSpy过滤技巧--nonsystem和--exclude精准锁定关键依赖【免费下载链接】AsmSpySimple command line assembly reference checker项目地址: https://gitcode.com/gh_mirrors/as/AsmSpyAsmSpy 是一款简单的命令行程序集引用检查器assembly reference checker专门用于扫描 .NET 项目的 bin 目录分析各 DLL 之间的引用关系并自动标出不同程序集引用同一程序集不同版本的冲突。但真实项目中输出往往混杂大量 System.、Microsoft.等系统程序集容易淹没真正的问题。本文围绕 AsmSpy 过滤技巧重点讲解--nonsystem与--exclude两个开关的用法帮助你快速排除噪音、精准锁定关键依赖。什么是 AsmSpy一个命令行程序集依赖检查工具AsmSpy 的使用非常简单把 bin 目录路径作为参数传给它即可。AsmSpy D:\Source\MyProject\MyProject\bin工具会递归读取目录下所有 DLL 与 EXE分析程序集引用关系。默认情况下它只显示存在版本冲突的引用加上--all-a才会列出全部程序集和全部引用。输出结果用三种颜色区分程序集来源非常直观颜色含义 绿色引用的程序集在指定目录中本地找到 黄色本地未找到但在全局程序集缓存GAC中安装 红色引用的程序集缺失需要重点排查为什么需要过滤从信息过载到精准定位一个典型的 .NET 项目 bin 目录里可能有几十上百个 DLL其中一半以上是框架自带的系统程序集如System.*、mscorlib、netstandard等。如果不做过滤AsmSpy 的输出会是这样Reference: System.Runtime.Serialization 3.0.0.0 by Microsoft.ServiceModel.Samples.XmlRpc 4.0.0.0 by Suteki.Shop Reference: System.Web.Mvc 2.0.0.0 by Microsoft.Web.Mvc 3.0.0.0 by MvcContrib系统程序集的版本冲突通常由运行时自动处理并非你真正需要关心的问题。真正需要关注的往往是你自己的业务程序集比如Newtonsoft.Json、NHibernate这类第三方依赖是否存在版本不一致。这时就轮到过滤开关登场了。核心技巧一--nonsystem 一键忽略系统程序集--nonsystem简写-n的作用是分析时直接跳过系统程序集只保留第三方和你自己的程序集。AsmSpy D:\Source\MyProject\MyProject\bin --nonsystem其判断逻辑位于 AssemblyInformationProvider.cs凡是名称以System.、Microsoft.、mscorlib、netstandard开头或使用系统公钥令牌签名的程序集都会被当作系统程序集跳过。这是一套启发式判断heuristic并非严格的安全校验但对日常依赖检查来说足够可靠。加上这个参数后输出立刻清爽很多——系统程序集的引用不再出现你只需聚焦在真正属于项目的依赖冲突上。✅ 这是最常用的第一条过滤规则。核心技巧二--exclude 按前缀排除指定程序集有些第三方程序集虽然不是系统程序集但同样会干扰你的判断。此时可以用--exclude简写-e按程序集全名前缀排除它们AsmSpy D:\Source\MyProject\MyProject\bin --exclude Newtonsoft.Json--exclude的特点是按程序集全名的前缀匹配忽略大小写例如--exclude log4net会同时排除log4net和log4net.Extended可以重复提供多次同时排除多个程序集判断逻辑位于 DependencyAnalyzer.cs 的引用解析阶段被排除的程序集不会进入依赖图。一次排除多个依赖的写法如下AsmSpy D:\Source\MyProject\MyProject\bin --exclude Newtonsoft.Json --exclude log4net --exclude NUnit.Framework进阶组合--nonsystem --exclude 精准锁定关键依赖实战中最推荐的组合是系统程序集全过滤 无关第三方逐个排除再配合--rsw--referencedstartswith只分析引用指定前缀程序集的程序集AsmSpy D:\Source\MyProject\MyProject\bin --nonsystem --exclude NUnit.Framework --exclude FluentAssertions --rsw Newtonsoft.Json这条命令的含义是跳过所有系统程序集剔除测试框架只看引用Newtonsoft.Json的程序集有哪些——一眼就能发现谁引用了旧版本、谁引用了新版本。从冲突到解决方案绑定重定向Binding Redirect当你通过过滤锁定冲突后下一步通常是修复。AsmSpy 还内置了绑定重定向生成能力使用-b--bindingredirect 文件名可以直接输出一份包含bindingRedirect规则的配置文件见 BindingRedirectExport.cs也可以使用-c--configurationFile读取 Web.config 或 App.config 中已有的重定向规则进行分析。如上图所示AsmSpy 先分析出某个程序集被多个版本引用如 4.0.0.0、6.0.0.0、9.0.0.0随后即可在app.config中生成oldVersion4.0.0.0-9.0.0.0、newVersion9.0.0.0的重定向规则把旧版本统一指向新版本彻底消除运行时冲突。与其他开关搭配组合出更多过滤玩法除了--nonsystem和--exclude下面几个开关也经常与过滤一起使用开关作用典型搭配-a/--all显示所有程序集与引用默认只看冲突与--nonsystem搭配查看全部非系统依赖-tr/--tree以依赖树形式输出配合--treedepth限制层级-i/--includesub递归搜索子目录多项目引用时更全面-s/--silent静默模式只显示警告和错误CI 构建时使用-dg/--dgml导出依赖关系图到 dgml 文件可视化分析依赖比如想在 CI 中自动检查依赖冲突可以这样用AsmSpy D:\Source\MyProject\MyProject\bin --nonsystem --silent --failOnMissing--failOnMissing-f会让工具在检测到缺失程序集时以非零错误码退出从而让构建失败把问题拦截在发布之前。常见问题 FAQQ--exclude能匹配完整程序集名吗A--exclude采用前缀匹配不区分大小写。想精确排除某个程序集时直接写它的名称即可它的强名称子程序集如log4net.Extended也会被一并排除。Q--nonsystem会不会误伤我的程序集A有可能。IsSystemAssembly的判定是启发式的如果项目里恰好有以Microsoft.开头的自有程序集它也会被当作系统程序集跳过。遇到这种情况可以反过来用--exclude精确排除干扰项而不使用--nonsystem。Q--nonsystem和--exclude可以同时用吗A完全可以。两条规则在依赖分析时同时生效源码见 DependencyAnalyzer.cs 的GetAssemblyReferenceInfo系统程序集和指定前缀的程序集都会被排除出依赖图。Q如何安装 AsmSpyAWindows 下可通过 Chocolatey 一键安装choco install asmspy随后即可在命令行直接使用AsmSpy命令。小结面对庞大的程序集依赖网络盲目分析只会浪费时间。掌握 AsmSpy 过滤技巧用--nonsystem剔除系统噪音、用--exclude排除无关依赖、用--rsw圈定关注范围你就能在几秒钟内精准锁定真正的版本冲突。配合绑定重定向与 CI 静默检查依赖管理从此变得简单可控。【免费下载链接】AsmSpySimple command line assembly reference checker项目地址: https://gitcode.com/gh_mirrors/as/AsmSpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
AsmSpy过滤技巧：--nonsystem和--exclude精准锁定关键依赖
AsmSpy过滤技巧--nonsystem和--exclude精准锁定关键依赖【免费下载链接】AsmSpySimple command line assembly reference checker项目地址: https://gitcode.com/gh_mirrors/as/AsmSpyAsmSpy 是一款简单的命令行程序集引用检查器assembly reference checker专门用于扫描 .NET 项目的 bin 目录分析各 DLL 之间的引用关系并自动标出不同程序集引用同一程序集不同版本的冲突。但真实项目中输出往往混杂大量 System.、Microsoft.等系统程序集容易淹没真正的问题。本文围绕 AsmSpy 过滤技巧重点讲解--nonsystem与--exclude两个开关的用法帮助你快速排除噪音、精准锁定关键依赖。什么是 AsmSpy一个命令行程序集依赖检查工具AsmSpy 的使用非常简单把 bin 目录路径作为参数传给它即可。AsmSpy D:\Source\MyProject\MyProject\bin工具会递归读取目录下所有 DLL 与 EXE分析程序集引用关系。默认情况下它只显示存在版本冲突的引用加上--all-a才会列出全部程序集和全部引用。输出结果用三种颜色区分程序集来源非常直观颜色含义 绿色引用的程序集在指定目录中本地找到 黄色本地未找到但在全局程序集缓存GAC中安装 红色引用的程序集缺失需要重点排查为什么需要过滤从信息过载到精准定位一个典型的 .NET 项目 bin 目录里可能有几十上百个 DLL其中一半以上是框架自带的系统程序集如System.*、mscorlib、netstandard等。如果不做过滤AsmSpy 的输出会是这样Reference: System.Runtime.Serialization 3.0.0.0 by Microsoft.ServiceModel.Samples.XmlRpc 4.0.0.0 by Suteki.Shop Reference: System.Web.Mvc 2.0.0.0 by Microsoft.Web.Mvc 3.0.0.0 by MvcContrib系统程序集的版本冲突通常由运行时自动处理并非你真正需要关心的问题。真正需要关注的往往是你自己的业务程序集比如Newtonsoft.Json、NHibernate这类第三方依赖是否存在版本不一致。这时就轮到过滤开关登场了。核心技巧一--nonsystem 一键忽略系统程序集--nonsystem简写-n的作用是分析时直接跳过系统程序集只保留第三方和你自己的程序集。AsmSpy D:\Source\MyProject\MyProject\bin --nonsystem其判断逻辑位于 AssemblyInformationProvider.cs凡是名称以System.、Microsoft.、mscorlib、netstandard开头或使用系统公钥令牌签名的程序集都会被当作系统程序集跳过。这是一套启发式判断heuristic并非严格的安全校验但对日常依赖检查来说足够可靠。加上这个参数后输出立刻清爽很多——系统程序集的引用不再出现你只需聚焦在真正属于项目的依赖冲突上。✅ 这是最常用的第一条过滤规则。核心技巧二--exclude 按前缀排除指定程序集有些第三方程序集虽然不是系统程序集但同样会干扰你的判断。此时可以用--exclude简写-e按程序集全名前缀排除它们AsmSpy D:\Source\MyProject\MyProject\bin --exclude Newtonsoft.Json--exclude的特点是按程序集全名的前缀匹配忽略大小写例如--exclude log4net会同时排除log4net和log4net.Extended可以重复提供多次同时排除多个程序集判断逻辑位于 DependencyAnalyzer.cs 的引用解析阶段被排除的程序集不会进入依赖图。一次排除多个依赖的写法如下AsmSpy D:\Source\MyProject\MyProject\bin --exclude Newtonsoft.Json --exclude log4net --exclude NUnit.Framework进阶组合--nonsystem --exclude 精准锁定关键依赖实战中最推荐的组合是系统程序集全过滤 无关第三方逐个排除再配合--rsw--referencedstartswith只分析引用指定前缀程序集的程序集AsmSpy D:\Source\MyProject\MyProject\bin --nonsystem --exclude NUnit.Framework --exclude FluentAssertions --rsw Newtonsoft.Json这条命令的含义是跳过所有系统程序集剔除测试框架只看引用Newtonsoft.Json的程序集有哪些——一眼就能发现谁引用了旧版本、谁引用了新版本。从冲突到解决方案绑定重定向Binding Redirect当你通过过滤锁定冲突后下一步通常是修复。AsmSpy 还内置了绑定重定向生成能力使用-b--bindingredirect 文件名可以直接输出一份包含bindingRedirect规则的配置文件见 BindingRedirectExport.cs也可以使用-c--configurationFile读取 Web.config 或 App.config 中已有的重定向规则进行分析。如上图所示AsmSpy 先分析出某个程序集被多个版本引用如 4.0.0.0、6.0.0.0、9.0.0.0随后即可在app.config中生成oldVersion4.0.0.0-9.0.0.0、newVersion9.0.0.0的重定向规则把旧版本统一指向新版本彻底消除运行时冲突。与其他开关搭配组合出更多过滤玩法除了--nonsystem和--exclude下面几个开关也经常与过滤一起使用开关作用典型搭配-a/--all显示所有程序集与引用默认只看冲突与--nonsystem搭配查看全部非系统依赖-tr/--tree以依赖树形式输出配合--treedepth限制层级-i/--includesub递归搜索子目录多项目引用时更全面-s/--silent静默模式只显示警告和错误CI 构建时使用-dg/--dgml导出依赖关系图到 dgml 文件可视化分析依赖比如想在 CI 中自动检查依赖冲突可以这样用AsmSpy D:\Source\MyProject\MyProject\bin --nonsystem --silent --failOnMissing--failOnMissing-f会让工具在检测到缺失程序集时以非零错误码退出从而让构建失败把问题拦截在发布之前。常见问题 FAQQ--exclude能匹配完整程序集名吗A--exclude采用前缀匹配不区分大小写。想精确排除某个程序集时直接写它的名称即可它的强名称子程序集如log4net.Extended也会被一并排除。Q--nonsystem会不会误伤我的程序集A有可能。IsSystemAssembly的判定是启发式的如果项目里恰好有以Microsoft.开头的自有程序集它也会被当作系统程序集跳过。遇到这种情况可以反过来用--exclude精确排除干扰项而不使用--nonsystem。Q--nonsystem和--exclude可以同时用吗A完全可以。两条规则在依赖分析时同时生效源码见 DependencyAnalyzer.cs 的GetAssemblyReferenceInfo系统程序集和指定前缀的程序集都会被排除出依赖图。Q如何安装 AsmSpyAWindows 下可通过 Chocolatey 一键安装choco install asmspy随后即可在命令行直接使用AsmSpy命令。小结面对庞大的程序集依赖网络盲目分析只会浪费时间。掌握 AsmSpy 过滤技巧用--nonsystem剔除系统噪音、用--exclude排除无关依赖、用--rsw圈定关注范围你就能在几秒钟内精准锁定真正的版本冲突。配合绑定重定向与 CI 静默检查依赖管理从此变得简单可控。【免费下载链接】AsmSpySimple command line assembly reference checker项目地址: https://gitcode.com/gh_mirrors/as/AsmSpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
