Qt 6.3.2中无法找到serialport模块的解决方法咨询

问题原因 #

你安装的libqt5serialport5和libqt5serialport5-dev是Qt5版本的串口模块，与当前使用的Qt6不兼容，因此无法被识别。

解决方案 #

1. 安装Qt6对应串口模块包 #

针对Debian/Ubuntu类发行版，执行以下命令安装Qt6串口开发依赖：

sudo apt-get install libqt6serialport6 libqt6serialport6-dev

2. 检查Qt Creator的Kit配置 #

• 打开Qt Creator，依次点击工具→选项→Kits
• 选中当前使用的Qt6 Kit，确认Qt版本为6.3.2，且其关联的Qt安装目录下存在SerialPort模块（路径通常为Qt/6.3.2/gcc_64/lib/cmake/Qt6SerialPort）
• 若Kit配置错误，重新指定正确的Qt6安装路径

3. 确认项目配置 #

确保.pro文件中正确声明模块：

QT += serialport

之后点击构建→清理项目，再重新构建项目

4. 通过Qt维护工具补装模块 #

如果系统包安装无效，可能是你通过Qt官方安装器安装Qt6时未勾选串口模块：

• 打开Qt Maintenance Tool（Qt维护工具）
• 选择添加或移除组件，找到已安装的Qt6.3.2版本
• 展开Additional Libraries，勾选Qt Serial Port
• 点击下一步完成安装，重启Qt Creator后重新构建项目

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