PAYATHON 2026

Qt6 新项目在 Automatic QML type registration 阶段构建失败怎么办？

数据阿明

现有日志只能确定：构建在生成 appuntitled_qmltyperegistrations.cpp 的 QML 类型注册步骤失败，根因尚不明确。应先获取该步骤的完整命令和错误输出，再检查 Kit、Qt 工具路径及构建缓存。仅凭 Error 1 和 Error 2，无法判断需要修改 CMakeLists.txt 的哪一行。

日志说明了什么？

日志中的失败位置是：

[ 54%] Automatic QML type registration for target appuntitled
... [appuntitled_qmltyperegistrations.cpp] Error 1

qt_add_qml_module() 会安排生成 QML 类型信息和注册代码。qmltyperegistrar 用于生成 C++ 注册代码和 .qmltypes 文件，通常由构建系统调用。根据现有日志，应先查看这一步执行的实际命令。Qt QML 模块文档、qmltyperegistrar 文档

后续的多个 Error 2 是构建失败向上层目标传播的结果，没有提供新的根因信息。parallel job execution disabled for Makefile 这行提示本身也不足以解释类型注册失败。

应用尚未成功构建，应先解决构建问题，再检查运行配置。

先取得完整构建输出

在 Qt Creator 中查看完整的编译输出，找到第一条 Error 1 之前的命令和诊断信息，不要只看问题列表中的错误摘要。

也可以在具备与该 Kit 相同 MSVC、Qt 环境的 PowerShell 会话中执行以下命令。建议在项目根目录运行，以便保存日志：

& "D:\Qt\Tools\CMake_64\bin\cmake.exe" --build "F:/shared/projects/tests/untitled/build/Desktop_Qt_6_11_0_MSVC2022_64bit-Debug" --target appuntitled --verbose --parallel 1 2>&1 | Tee-Object -FilePath .\build-verbose.log

--verbose 显示实际构建命令，--parallel 1 减少并行输出交错，方便定位首个失败步骤。这些参数用于诊断，关闭并行并不一定能修复问题。CMake 构建参数说明

重点查看：

  • 失败命令调用的是哪个 Qt 安装目录中的工具。
  • 是否报告工具无法启动、缺少 DLL、输入文件不存在或无法写入输出文件。
  • 是否出现明确的 JSON、类型信息或命令行参数错误。

如果仍没有诊断信息，可以查看构建目录中的 CMakeFiles/appuntitled.dir/build.make，找到生成 appuntitled_qmltyperegistrations.cpp 的规则，核对命令和输入路径。不要直接修改这个自动生成的文件。

检查 Kit 和构建缓存

按以下顺序排查，每次只改变一个条件：

  1. 核对 Kit 中的 Qt 版本、编译器和架构，确保实际使用的是预期的 Qt 6.11.0 MSVC2022 64bit 配置。
  2. 对照详细日志检查工具路径，确认没有混入其他 Qt 安装目录。原日志已经显示 CMake 来自 D:\Qt\Tools\CMake_64\bin\cmake.exe，因此不能直接归因为使用了系统中另一份 CMake。
  3. 保留旧构建目录和日志，指定全新的构建目录，重新配置并构建，以检查旧缓存或生成文件是否影响构建。
  4. 如果新目录仍然失败，并且已安装 Ninja，可以将 CMake generator 改为 Ninja，再次使用新的构建目录进行对照。切换 generator 后不要复用原来的 jom 构建目录。

Ninja 对照构建有助于缩小排查范围，但目前没有证据证明 jom 是根因，也不能保证切换后一定成功。

CMakeLists.txt 需要修改吗？

现有信息不足以判断所贴出的配置需要修改。例如：

qt_standard_project_setup(REQUIRES 6.10)

REQUIRES 6.10 表示要求至少使用该 Qt 版本，并启用截至该版本的相关 Qt CMake policies，并非要求安装的 Qt 版本必须恰好是 6.10。使用 Qt 6.11.0 不会仅因这个数值而产生版本冲突。该命令还会在相关变量未预先设置时，为后续目标启用 CMAKE_AUTOMOC 等默认配置。qt_standard_project_setup 文档

不要为了绕过当前步骤而添加 NO_GENERATE_QMLTYPES，也不要手工创建空的 appuntitled_qmltyperegistrations.cpp。前者会禁用自动类型信息和注册代码生成，后者可能掩盖真正的生成失败；在缺少诊断信息时，都不应作为修复方案。Qt 自动类型注册说明

根据具体错误处理

如果工具无法启动或提示缺少 DLL，应检查该 Qt 安装及其运行依赖；如果输入文件不存在或不可读，应核对命令中的元类型 JSON 路径及前置生成步骤；如果输出文件无法写入，应检查构建目录权限和文件占用。等日志明确指向具体配置或类型声明后，再修改对应内容。

继续定位需要第一条失败命令、该命令的完整输出，以及新构建目录是否仍能复现问题。现有日志没有包含这些信息，暂时无法给出已确认有效的单一修复方案。

备注：内容仅供参考。