万万没想到，曾经随手改的一行依赖竟然导致程序无法发布为单文件，被这个问题困扰了一整天，好恨！！！
起因
在使用.NET8重构离线注册机并引入新版授权算法AddCode后，发布为单文件，运行后报错FileNotFoundException：
排查
这是个被全局捕获的未处理异常，在开发阶段从未出现，调试非单文件发布的可执行文件并没有问题，由此断定是单文件发布后引入的Bug。
从异常堆栈顶层开始排查，注释掉MainViewModel构造函数中引用到AddCode程序集中类的代码，运行后还是报错。对比提交历史后发现在XAML中依赖了AddCode程序集中的一个枚举：
<UserControl x:Class="Reg.Views.GenerateRegCode"
……
xmlns:addcode="clr-namespace:AddCode;assembly=AddCode"
mc:Ignorable="d"
d:DesignHeight="350" d:DesignWidth="520">
……
<TextBlock Text="激活方式" FontWeight="Bold" HorizontalAlignment="Left" Grid.Row="2" VerticalAlignment="Center"/>
<StackPanel Grid.Row="2" Grid.Column="1" VerticalAlignment="Center" Orientation="Horizontal">
<RadioButton Content="离线激活" VerticalAlignment="Center" GroupName="ActiveWay" IsChecked="{Binding SelectedActiveWay,Converter={StaticResource activeWayConverter},ConverterParameter={x:Static addcode:LicenseWays.OfflineAuth}}" />
<RadioButton Content="脱机激活" VerticalAlignment="Center" GroupName="ActiveWay" IsChecked="{Binding SelectedActiveWay,Converter={StaticResource activeWayConverter},ConverterParameter={x:Static addcode:LicenseWays.LocalAuth}}" Margin="20 0 0 0" />
</StackPanel>
……
</UserControl>
再次注释掉这段代码后，发布成单文件后就不抛异常了。
解决
问题点找着了，如何解决呢？
翻阅.NET文档中有关单文件发布的说明，除了用到反射的代码需要留意程序集路径外，没提到XAML中不能使用依赖程序集中定义的枚举，以往基于.NET5开发后发布为单文件的程序，都存在UI和后台均依赖第三方程序集的代码，从没出现过上述异常。
如此，一定是我的引用方式不对。
对比以往的项目后发现同样导入AddCode依赖，之前是这么写的
<ItemGroup>
……
<PackageReference Include="AddCode" Version="2.6.6" />
……
</ItemGroup>
而本次出问题的项目中多了PrivateAssets和IncludeAssets：
<ItemGroup>
……
<PackageReference Include="AddCode" Version="3.1.1" PrivateAssets="All" IncludeAssets="All" />
……
</ItemGroup>
去掉PrivateAssets和IncludeAssets后再次发布为单文件，运行起来一切正常。
反思
记不清什么时候改的依赖，目的大概是考虑到AddCode仅在本注册机内部使用，不想隐式传递依赖（也不可能会在其它项目中引用注册机）就顺手加上了，谁能想到这个无心之举给今日挖了一个如此大的坑。
至于为什么标记为PrivateAssets后发布为单文件在运行时会找不到程序集，我推测是作为私有资产的程序集AddCode不会被复制到输出目录，在编译后的产物中缺少该程序集。
为验证此猜想，我比较了标记为PrivateAssets前后可执行程序的大小，如下图所示：
可见未标记后运行正常的可执行程序大了45kb，而AddCode.dll大小为41kb，我的猜想应该没错。
Deepseek给的回答也验证了这一点。
2025年8月26日星期二・天霸