Visual Studio 2017 x64环境生成可分发DLL遇System.BadImageFormatException求助

作为常年在Linux和Windows之间横跳的开发者，太懂你这种跨平台开发踩坑的酸爽了！针对你遇到的System.BadImageFormatException，这几乎百分百是架构不匹配导致的——毕竟你要做的是x64 DLL，一旦调用链里出现x86的组件，Windows就会直接抛出这个错误。结合你的场景（VS2017 Community、.NET Core相关DLL），给你梳理几个必查的关键点：

• 检查项目的平台目标配置
  右键你的DLL项目 → 属性 → 生成 → 平台目标，务必选x64，别用Any CPU或者x86。重点提醒：如果你的项目引用了其他类库、第三方NuGet包或者原生DLL，这些依赖也必须是x64版本的，哪怕一个x86的依赖都会直接触发这个异常。另外，如果是.NET Framework类型的项目，要确保“首选32位”选项是未勾选的。

• 切换调试/运行的解决方案平台
  别只改项目配置！在Visual Studio顶部工具栏，找到解决方案平台的下拉框（默认可能显示Any CPU），一定要手动切换到x64。很多人栽在这里：项目配置改了x64，但调试时还是用Any CPU模式运行，导致程序加载了错误架构的产物。

• 彻底清理并重建解决方案
  旧的编译产物（比如之前误编译的x86版本）很容易残留搞事情。按这个步骤来：

  1. 菜单栏点击「生成」→「清理解决方案」
  2. 手动删除项目目录下的bin和obj文件夹（这一步比清理解决方案更彻底）
  3. 重新生成整个解决方案，确保输出目录里的所有文件都是x64架构的。

• 确认.NET Core运行时和发布配置
  你的错误信息提到netcoreap...，说明是.NET Core项目。先打开命令提示符运行dotnet --info，检查已安装的运行时里有没有对应目标框架的x64版本。如果是发布DLL，要确保发布命令指定了x64架构，比如：

  dotnet publish -c Release -r win-x64 --self-contained false
  

  这样生成的产物才是专门针对Windows x64平台的。

• 检查调用DLL的测试程序架构
  如果你是用另一个项目来测试这个DLL，那测试项目的平台目标也必须是x64，绝对不能是x86或者默认的Any CPU（有些情况下Any CPU会以32位模式启动）。

最后再敲个黑板：Windows的架构匹配逻辑比Linux严格得多，整个调用链上的所有组件——你的DLL、依赖库、调用它的程序——必须全是x64，只要有一个环节错配，就会抛出这个异常。慢慢排查，应该很快能解决！

内容的提问来源于stack exchange，提问作者While-E