本页内容

未解析的别名

qmllint 将此警告类别拼写为“[unresolved-alias] ”。

未解析的别名

发生了什么?

属性别名应持有对另一个属性的引用,另请参阅《QML 对象属性——属性别名》。在此情况下,它持有对一个未找到的属性的引用。

为什么这有问题?

包含未解析别名的组件实例在运行时将无法创建:它们将被设为 null。

示例

import QtQuick

Item {
    id: someId
    property int helloWorld

    property alias helloWorldAlias: helloWorld      // not ok: aliases have to refer by id
    property alias helloWorldAlias2: someId.helloWorlddd    // not ok: no helloWorlddd in someId
    property alias helloWorldAlias3: someIddd.helloWorld    // not ok: someIddd does not exist
}

要解决此警告,请确保别名属性中的 id 和 property 确实存在:

import QtQuick

Item {
    id: someId
    property int helloWorld

    property alias helloWorldAlias: someId.helloWorld   // ok: alias refers by id
    property alias helloWorldAlias2: someId.helloWorld  // ok: helloWorld does exist in someId
    property alias helloWorldAlias3: someId.helloWorld  // ok: someId does exist
}

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.