QT Creator构建失败:-1: error: Unknown module(s) in QT: serialport

Qt Creator和Qt SDK版本：

Product: Qt Creator 17.0.0
Based on: Qt 6.9.1 (MSVC 2022, x86_64)
Built on: Jun 17 2025 16:32:24
From revision: 4983f08c47
 

问题：

在使用串口的时候，在pro 文件中添加了 QT       += serialport，仍然显示构建失败:-1: error: Unknown module(s) in QT: serialport；

原因：

serialport 串口模块在安装的时候没有添加；

操作：

在弹出的窗口中继续选择下一步，

选择 添加或者删除组件

找到 Additional Libraries ， 在下面找到 serialport 勾选上继续下一步安装就可以了；

至此，组件添加完成，重启软件重新编译！