Qt 6.4使用QSerialPort库报错:未知serialport模块求助
解决Qt 6.4中QSerialPort模块报错问题
针对你遇到的Project ERROR: Unknown module(s) in QT: serialport错误,按以下步骤排查解决:
检查Qt SerialPort组件是否安装
Qt SerialPort属于附加模块,默认安装Qt 6.4时可能未包含。打开Qt Maintenance Tool,找到你安装的Qt 6.4版本,在「Add-ons」分类下勾选Serial Port组件,完成安装更新。验证Kit配置正确性
打开Qt Creator的「工具」->「选项」->「Kits」,选中当前使用的开发套件,确认其关联的Qt版本为已安装SerialPort组件的6.4版本,避免使用了未安装该模块的Qt环境。清理并重建项目
组件安装完成后,回到Qt Creator:- 执行「Build」->「Clean All」清理旧编译文件
- 执行「Build」->「Run qmake」重新生成项目配置
- 重新编译项目
额外注意事项
- Linux系统下,除了Qt组件,还需要安装系统级依赖包,例如Debian/Ubuntu系可执行:
sudo apt install libqt6serialport6-dev - Windows系统确保Maintenance Tool下载的组件完整,安装路径无权限问题。
内容的提问来源于stack exchange,提问作者Irvin Ortiz
相关产品推荐
相关产品推荐

