QML调用speed组件报错‘property name <speed> invalid. (M16)’求解决

错误原因 #

QML是大小写敏感的语言，且自定义组件的命名规范要求首字母大写。你的RPM、EngCoolTemp组件均遵循大写开头的命名规则，但speed以小写开头，会被QML解析为属性而非自定义组件，编译器找不到对应组件，因此抛出“property name invalid”的M16错误。

解决方案 #

1. 统一组件调用的大小写 #

将代码中小写的speed组件调用改为大写开头的Speed，同时确保你的自定义组件文件名为Speed.qml（QML组件文件名必须与组件名完全一致，包括大小写）。

修改后的Speed仪表盘代码片段：

// Speed Gauge
Rectangle {
    id: id_speedArea

    anchors {
        horizontalCenter: parent.horizontalCenter
    }
    width: parent.width * 0.4
    height: width
    color: "black"
    radius: width / 2
    z: 1

    Speed {
        id: id_speed
        anchors.fill: id_speedArea
        anchors.margins: id_speedArea.width * 0.025
    }
}

2. 验证组件文件的路径与导入 #

• 确保Speed.qml文件与dashboard.qml处于同一目录；
• 若组件在子目录中，需在dashboard.qml顶部添加对应导入语句，例如：

  import "./components" // 假设Speed.qml位于components子目录下
  

3. 排查组件内部命名冲突 #

若修改大小写后仍报错，检查Speed.qml内部是否定义了名为speed的属性，避免组件名与内部属性名重复导致解析混淆。

内容的提问来源于stack exchange，提问作者Mohamed sadok Jomaa