自包含.NET Core类库缺失运行时文件，发布控制台应用却正常

这个问题其实是.NET Core设计上的一个关键点——类库项目本身不支持自包含发布，只有可执行项目（比如控制台App）才支持自包含部署（SCD）。

背后的原因 #

类库的定位是被其他宿主程序（比如你的Electron/Edge应用，或者另一个.NET程序）加载和调用的，它本身并不负责启动.NET运行时。自包含部署的核心是把运行时和可执行文件打包在一起，让程序能脱离系统的.NET环境独立运行——但类库不需要独立运行，它的运行时依赖由加载它的宿主来提供。

所以当你发布类库时，即使勾选了"自包含"，SDK也只会输出类库本身的DLL，不会打包运行时文件；而控制台App作为可执行项目，SDK会自动把对应的.NET运行时、宿主组件（比如hostfxr.dll、coreclr.dll）和依赖项一起打包进去。

针对Electron/Edge场景的解决方案 #

既然你要在Electron/Edge中使用这个类库，有几个可行的方案：

1. 把类库包装成自包含的控制台应用

• 修改项目的OutputType为Exe，把类库的逻辑封装成一个控制台程序（比如提供命令行接口，让Electron通过子进程调用）。
• 发布时使用自包含参数：

  dotnet publish -r win-x64 -c Release /p:SelfContained=true
  

  （把win-x64换成你需要的目标运行时，比如linux-x64或osx-x64）
• Electron可以通过child_process模块调用这个Exe，通过标准输入输出或IPC和它交互。

2. 手动打包运行时文件（不推荐）

如果你坚持要直接使用类库DLL，可以从同版本的控制台App发布目录中，复制所有运行时相关文件（包括hostfxr.dll、coreclr.dll以及Microsoft.NETCore.App文件夹等）到类库的发布目录中。

• 注意：必须保证运行时版本和类库的目标框架完全匹配，否则可能出现兼容性问题；而且后续更新.NET版本时需要手动同步文件，维护成本较高。

3. 使用单文件发布（针对控制台包装方案）

如果觉得控制台App的文件太多，可以用.NET 5+支持的单文件发布，把所有依赖（包括运行时）打包成一个单独的Exe：

dotnet publish -r win-x64 -c Release /p:PublishSingleFile=true /p:SelfContained=true /p:PublishTrimmed=true

PublishTrimmed=true还会裁剪掉不需要的代码，进一步减小文件体积。

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