自定义Slider.qml编译报错：属性名称无效(M16)求助

使用自定义Slider组件时编写了如下代码：

Slider
{
    id: sldRed
    anchors.horizontalCenter: parent.horizontalCenter
    anchors.top: parent.top
    anchors.topMargin: 80
    width: 450
    minimum: 0
    maximum: 100
    value: 0
    step: 1
    backgroundEmpty: "lightgray"
    backgroundFull: "red"
    pressCircle: "red"
    onValueChanged:
    {
//        pwmRed.setPwmValue(value);
    }
}

编译时出现以下错误：

Invalid property name "minimum". (M16)
Invalid property name "maximum". (M16)
Invalid property name "step". (M16)
Invalid property name "backgroundEmpty". (M16)
Invalid property name "pressCircle". (M16)

项目中已包含定义了上述所有属性的Slider.qml文件：

import QtQuick 2.2

Item {
    id:slider
    height: heightSlider

    signal released(int value)
    signal pressed()

    property real value: 1
    onValueChanged: updatePos();
    property real minimum: 1
    property real maximum: 1
    property real step: 1
    property int xMax: width - handle.width
    onXMaxChanged: updatePos();
    onMinimumChanged: updatePos();

    property color backgroundEmpty: "lightgrey";
    property color backgroundFull: "#39F724";
    property real  backgroundopacity: 1;
    property real  backgroundopacityFull: 1;
    property color pressCircle: "#39F724"
    property color handleGrad1: "lightgray"
    property color handleGrad2: "gray"
    property real  heightSlider: 10
    property real  fullCircle: 30
    property real  circleWidth: 70
    property real  circleHeight: 70

// ... 省略其余代码
}

这些错误本质是QML引擎没有识别到你的自定义Slider组件，而是加载了系统默认的Slider（比如QtQuick.Controls中的Slider，它没有这些自定义属性），按以下步骤排查：

• 检查组件导入是否正确
  在使用自定义Slider的QML文件顶部，确保导入了Slider.qml所在的目录。比如：

  • 如果Slider.qml和当前文件在同一目录，添加 import "."
  • 如果Slider.qml在components子目录下，添加 import "./components"

• 避免命名冲突
  如果你同时导入了QtQuick.Controls模块（比如import QtQuick.Controls 2.15），系统默认的Slider会和你的自定义Slider重名，QML引擎会优先加载系统组件。解决办法：

  1. 给自定义Slider改个名字，比如把Slider.qml重命名为CustomSlider.qml，使用时写CustomSlider {...}
  2. 或者在导入时使用别名区分：import QtQuick.Controls 2.15 as Controls，使用系统Slider时写Controls.Slider，自定义Slider直接写Slider

• 确认文件路径是否在QML搜索路径中
  在Qt Creator中检查项目设置：

  1. 右键项目 -> 选择"添加库" -> 确认自定义QML组件所在目录被添加到QML导入路径
  2. 或者在.pro文件中添加QML_IMPORT_PATH += 你的Slider.qml所在目录，确保QML引擎能找到该文件

• 验证组件加载优先级
  可以尝试在自定义Slider的Component.onCompleted中打印日志，确认是否被正确加载：

  Item {
      id:slider
      // ... 现有属性
      Component.onCompleted: console.log("自定义Slider加载成功")
  }
  

  如果控制台没有输出，说明组件没被正确加载，回到前面的步骤检查路径和导入。

内容的提问来源于stack exchange，提问作者Clive N