VS2019中VB开发DLL无法使用SerialPort的问题排查

1. 命名空间未导入 #

窗体/用户控件项目可能默认在项目级导入了System.IO.Ports命名空间，而DLL类库项目没有。直接在使用SerialPort的代码文件顶部添加：

Imports System.IO.Ports

2. 项目引用未正确添加 #

• 如果你的DLL项目基于**.NET Framework**：
  不需要通过NuGet安装System.IO.SerialPort，直接右键项目→添加引用→在程序集列表里找到System.IO.Ports并勾选，确定后即可使用。
• 如果是基于**.NET Core/.NET 5+：
  右键项目→管理NuGet程序包**→查看“已安装”标签，确认System.IO.Ports存在；若未找到，重新安装一次包，之后清理并重建项目。

3. 目标框架版本不兼容 #

右键项目→属性→应用程序标签，查看目标框架：

• 若用.NET Framework，确保版本≥4.0（System.IO.Ports从4.0版本开始内置）；
• 若用.NET Core，确保版本≥3.0（System.IO.Ports NuGet包从3.0版本开始支持）。
  版本过低的话，升级到兼容的框架版本后重试。

4. 项目类型的默认引用差异 #

Windows窗体项目会自动包含部分与硬件交互的系统程序集引用，但类库（DLL）项目不会。这就是相同代码在窗体中正常、DLL中报错的核心原因之一，需要手动为DLL项目补充必要的引用。

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