Visual Studio C#中DLL依赖System.IO.Ports丢失的原因及解决方法

为什么会出现这个错误？ #

你的DLL只是编译时引用了System.IO.Ports程序集，并没有将它打包到自身的DLL文件中。默认情况下，.NET类库项目不会自动把依赖的第三方程序集（包括System.IO.Ports这类官方NuGet包）嵌入或复制到输出目录的依赖项里，导致调用方项目运行时找不到这个必需的程序集。

另外两种可能的原因：

• 你的DLL项目中，System.IO.Ports引用的**“复制本地”属性未开启**，编译后该程序集没有被复制到输出目录，调用方引用你的DLL时自然拿不到这个依赖文件。
• 调用方项目的运行环境中，没有安装或匹配版本（7.0.0.0）的System.IO.Ports程序集，比如调用方使用的.NET版本与你的DLL依赖版本不兼容。

解决办法 #

方法1：开启“复制本地”属性 #

在你的DLL项目里：

1. 右键点击System.IO.Ports引用 → 选择“属性”。
2. 将“复制本地”设置为True。
3. 重新编译项目，此时System.IO.Ports.dll会被复制到你的DLL输出目录中。调用方项目引用你的DLL时，这个依赖文件也会被同步复制到调用方的输出目录，运行时就能找到它。

方法2：将依赖程序集嵌入到你的DLL中 #

如果想彻底消除外部依赖，可以把System.IO.Ports直接嵌入到你的DLL里：

1. 通过NuGet包管理器搜索安装Costura.Fody工具。
2. 安装完成后重新编译你的DLL，工具会自动将所有依赖的程序集打包到主DLL中，调用方只需引用你的DLL即可，无需额外依赖。

方法3：让调用方安装对应NuGet包 #

直接告知使用你的DLL的项目，安装System.IO.Ports 7.0.0版本的NuGet包，这样调用方项目的运行环境中就会存在该程序集，错误自然消失。

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