Qt for Python中QML组件“Cannot override FINAL property”错误排查

问题根源 #

你遇到的核心问题是Qt资源系统缓存了旧的Light.qml内容——即使你修改甚至清空了本地文件，运行时加载的依然是缓存里的旧版本（也就是之前包含width/height属性的版本，而Item的width/height是FINAL属性，无法被重写）。你当前的Light.qml代码完全合规，没有重写FINAL属性，代码本身不存在问题。

解决步骤 #

• 清理构建缓存
  删除项目build目录下的所有文件，重新执行构建流程（qmake/make或CMake构建），强制生成新的资源文件。
• 强制更新资源文件
  手动编译项目的qrc资源文件，执行对应命令：

  rcc -binary your_project.qrc -o qrc_your_project.rcc
  

  替换your_project.qrc为你实际的资源文件名，完成后重新运行程序。
• IDE缓存清理（针对Qt Creator）
  依次点击菜单栏选项：Build -> Clean All → Build -> Run qmake → Build -> Rebuild All，彻底清理IDE缓存并重新构建项目。
• 排查导入路径（可选）
  检查main.qml中导入Light组件的语句，确保路径指向你自定义的qrc:/devices/Light/，避免和第三方库中的同名组件产生导入冲突（Qt原生无内置Light组件，该情况概率极低）。

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