MacOS下Qt运行qmake提示未知模块multimedia、multimediawidgets如何解决

官方Qt安装器安装场景 #

• 启动Qt Maintenance Tool（Qt维护工具），选择「添加或移除组件」进入组件管理页
• 定位到你项目所用的Qt版本（如Qt 5.15、Qt 6.x分支），展开该版本的组件列表
• 在*附加库（Additional Libraries）*分类下，勾选「Qt Multimedia」和「Qt Multimedia Widgets」对应组件
• 点击下一步完成组件安装即可

Homebrew安装Qt场景 #

• 打开终端执行命令安装对应模块：brew install qt-multimedia
• 若安装后仍无法识别，执行brew link qt-multimedia --force完成模块关联

项目配置验证 #

安装完成后需确认项目配置正确：

• 项目.pro文件中已添加配置：QT += multimedia multimediawidgets
• 清理项目原有构建缓存，重新执行qmake后再进行构建
• 确认当前项目使用的构建套件，和安装多媒体模块的Qt版本一致，避免版本不匹配导致识别异常

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