Qt Creator适配MacOS 11.1 SDK时构建项目失败的解决咨询
Qt5.15.2内置的macOS平台构建脚本sdk.mk,会在qmake运行阶段将检测到的macOS SDK版本写入.qmake.stash缓存文件,在make执行阶段对比缓存记录的版本与当前系统实际检测到的SDK版本,一旦字符串不匹配就直接终止构建。
即使手动删除项目构建目录,只要存在残留的qmake缓存、Xcode命令行工具路径未正确关联,就会持续触发版本不匹配的报错。
关联正确的Xcode命令行工具路径
执行命令确认当前命令行工具指向:xcode-select -p
若输出路径不是/Applications/Xcode.app/Contents/Developer,执行切换命令:sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
切换完成后执行xcodebuild -showsdks,确认能正常识别macOS 11.1 SDK。全量清除qmake残留缓存
仅删除项目构建目录无法覆盖所有缓存位置,需删除以下路径下的所有qmake缓存文件:- 项目源码目录下的
.qmake.stash、.qmake.cache - 用户目录全局缓存
~/.qmake.stash - Qt安装目录下的mkspecs缓存
/usr/local/Cellar/qt/5.15.2/mkspecs/.qmake.stash
可直接执行批量删除命令:find ~ /Users/joefresna/VideoImageEdit /usr/local/Cellar/qt/5.15.2 \( -name ".qmake.stash" -o -name ".qmake.cache" \) -delete
- 项目源码目录下的
配置qmake参数绕过SDK版本硬校验
在Qt Creator项目的qmake构建步骤中,给qmake追加额外参数:CONFIG+=sdk_no_version_check
该参数会直接关闭sdk.mk脚本中的版本比对中断逻辑,不会影响Qt本身的兼容性警告输出。修正构建套件(Kit)的编译器匹配
此前更换编译器未生效的核心原因是未匹配Qt的ABI要求:- 将Kit下的C编译器设置为
/usr/bin/clang,C++编译器设置为/usr/bin/clang++,避免手动选择其他第三方编译器 - 确认Qt版本路径指向
/usr/local/Cellar/qt/5.15.2/bin/qmake,无旧版本路径残留 - 删除qmake参数中多余的
CONFIG+=x86_64配置(Homebrew安装的Qt5.15.2为通用二进制,无需手动指定架构)
- 将Kit下的C编译器设置为
验证构建流程
完成配置后,选择菜单栏「构建 > 清理项目」,再依次执行qmake、make步骤,即可正常完成构建。
内容的提问来源于stack exchange,提问作者Joe Fresna

