Qt Creator运行CMake提示版本不支持无file-api如何解决
Qt CMake版本不支持/File API识别失败修复方案
Qt Creator 7.0.x在Windows平台存在CMake识别bug,你安装的CMake 3.21.1版本本身满足最低3.14的要求,仅为IDE识别异常,按以下步骤操作即可修复:
- 移除错误的自动检测CMake配置
打开Qt Creator顶部菜单「工具→选项→Kits→CMake」,选中所有带红色感叹号的已配置CMake条目,点击右侧删除按钮全部清空。 - 手动指定CMake可执行文件路径
点击「添加」按钮,在弹出的文件选择框中手动定位到Qt自带CMake的可执行文件,默认安装路径为C:\Qt\Tools\CMake_64\bin\cmake.exe,注意不要选中系统中其他同名cmake程序、也不要选到bin目录的上级路径。选中后等待IDE自动检测,正常情况下条目旁的红色感叹号会消失,「Supports file API」状态会更新为Yes。 - 清理残留缓存(手动指定路径后仍异常时操作)
完全退出Qt Creator,删除两类缓存文件:- 进入
C:\Users\<你的当前用户名>\AppData\Roaming\QtProject\qtcreator\目录,删除所有名称包含cmake的配置文件 - 进入你的Qt项目对应的构建输出目录,删除
CMakeCache.txt文件和.cmake隐藏文件夹
重启Qt Creator后重新执行上一步的CMake添加操作即可。
- 进入
- 排查路径兼容问题
如果Qt安装在C:\Program Files等需要管理员权限的目录,或者安装路径包含中文、全角字符、特殊符号,IDE调用CMake时会因权限不足、路径转义失败无法读取File API接口。可以将Qt安装目录下的Tools\CMake_64文件夹剪切到纯英文、无特殊字符、无权限限制的路径(例如D:\devtools\CMake_64),再在Qt Creator中手动指定新路径下的bin\cmake.exe。 - 极端兼容方案
以上操作全部无效时,直接卸载Qt自带的CMake组件,安装3.17~3.24区间的64位Windows版CMake(该版本段和Qt Creator 7.0.2兼容性最优,不建议使用3.30以上的过高版本避免新的兼容问题),安装时勾选将CMake添加到系统PATH,重启Qt Creator后会自动识别到系统安装的CMake,识别状态正常。
配置完成验证:回到项目界面点击「Run CMake」,不再弹出版本不支持报错,顶部工具栏的构建、运行按钮从灰色不可用恢复为可点击状态,即可正常编译启动项目。
内容的提问来源于stack exchange,提问作者Dave Bowman
相关产品推荐
相关产品推荐

