WinForms应用依赖.dll扩展迁移及程序集加载报错咨询

嘿，我之前折腾WinForms程序的时候也碰到过一模一样的问题——把一堆dll塞在主目录里太乱，移走又报加载失败的错。给你几个亲测有效的方案，按需选就行：

这是.NET框架自带的方案，不用写额外代码，改个配置文件就行：

• 找到项目里的app.config（发布后会变成你的应用名.exe.config），打开它
• 在<configuration>节点里加个<runtime>节点，配置privatePath指定你要放dll的子文件夹，比如我习惯用Libs：

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <!-- 可以指定多个子路径，用分号隔开 -->
      <probing privatePath="Libs;Libs\CSV;Libs\MySQL" />
    </assemblyBinding>
  </runtime>
  <!-- 保留你原来的其他配置 -->
</configuration>

• 把Debug里的KBCsv、MySQL相关dll全移到你指定的Libs（或子文件夹）里，运行程序就行，.NET会自动去这些路径找需要的程序集。

⚠️ 注意：这个方法只对非强命名的dll有效，如果你的组件是强签名的，得用下面的方案2。

如果用的是带强签名的dll（比如官方发布的MySQL组件），得给每个dll单独配置绑定规则：

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <!-- 配置KBCsv的路径 -->
      <dependentAssembly>
        <assemblyIdentity name="KBCsv" publicKeyToken="xxxxxx" culture="neutral" />
        <codeBase version="x.x.x.x" href="Libs/KBCsv.dll" />
      </dependentAssembly>
      <!-- 配置MySQL Data组件 -->
      <dependentAssembly>
        <assemblyIdentity name="MySql.Data" publicKeyToken="c5687fc88969c44d" culture="neutral" />
        <codeBase version="x.x.x.x" href="Libs/MySql.Data.dll" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

• 要把publicKeyToken和version换成对应dll的实际值：可以右键dll→属性→详细信息里找，或者用ILDasm工具查看
• href填dll的相对路径，把dll移到对应位置就ok了。

如果上面的配置方案满足不了需求（比如要动态切换dll版本、路径是动态生成的），可以在程序启动时手动接管加载逻辑：

• 打开Program.cs，在启动主窗体的代码前，注册程序集解析事件：

using System.Reflection;
using System.IO;

namespace YourWinFormsApp
{
    static class Program
    {
        [STAThread]
        static void Main()
        {
            // 注册解析事件，找不到dll时会触发
            AppDomain.CurrentDomain.AssemblyResolve += CurrentDomain_AssemblyResolve;
            
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            Application.Run(new MainForm());
        }

        private static Assembly CurrentDomain_AssemblyResolve(object sender, ResolveEventArgs args)
        {
            var assemblyName = new AssemblyName(args.Name);
            // 指定dll存放的路径，这里用主目录下的Libs文件夹
            string dllPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Libs", $"{assemblyName.Name}.dll");
            
            if (File.Exists(dllPath))
            {
                // 从指定路径加载程序集
                return Assembly.LoadFrom(dllPath);
            }
            // 找不到就返回null，让系统继续用默认逻辑查找
            return null;
        }
    }
}

• 把所有需要的dll移到Libs文件夹，这样系统找不到dll时，就会触发这个事件，我们手动从指定路径加载。这个方法灵活性很高，还能加日志、版本判断之类的逻辑。

• 别漏了dll的依赖项！比如KBCsv可能还有配套的小dll，也要一起移到目标文件夹
• 发布应用时，记得把dll文件夹一起打包，不然用户那边还是会报错
• 如果你用的是.NET Core/.NET 5+的WinForms，配置方式略有不同，但程序集解析事件的方法是通用的，你这情况应该是.NET Framework，上面的方案都能用

内容的提问来源于stack exchange，提问作者Jay