QML自定义组件重命名后加载失败，报错‘IconButton is not a type’求助

嘿，我之前也踩过一模一样的坑！这种报错基本都是QML组件的命名规则或者文件配置出了问题，给你列几个最可能的原因和解决办法：

• 文件名必须和组件名严格一致（大小写敏感！）
  QML自定义组件的核心规则就是：组件类名必须和.qml文件名完全匹配，包括大小写。比如你把组件命名为IconButton，那对应的文件必须叫IconButton.qml，不能是iconbutton.qml或者Iconbutton.qml——Qt对这个要求特别严，哪怕大小写错了都会认不出来。你先检查一下你的文件名是不是和组件名完全对应上了。

• 确认文件在正确的路径/资源里
  从报错信息qrc:/screens/qml/x86/Test.qml来看，你的主QML是在qrc资源的这个路径下。那你要确保IconButton.qml也被正确添加到了这个路径的资源里，而不是放在其他文件夹或者没加入qrc。如果是本地文件路径，也要保证它和Test.qml在同一个目录，并且项目编译时能正确复制这个文件。

• 清理Qt的缓存和构建目录
  Qt有时候会缓存旧的QML组件信息，哪怕你改了文件名，缓存里还留着旧的记录。这种情况你可以试试：

  1. 删除项目的构建目录（就是cmake或者qmake生成的那个build文件夹）
  2. 重启Qt Creator
  3. 重新编译整个项目
     很多时候清完缓存就能解决这种“明明文件在却找不到”的问题。

• 检查拼写错误
  虽然你说内容完全一样，但还是仔细核对一下：主QML里引用的IconButton和文件名、组件ID的拼写是不是完全一致？有没有少写一个字母或者拼错（比如把IconButton写成IconButon）？这种低级错误有时候真的容易忽略。

你先按这几个步骤排查一下，大概率能解决问题！

备注：内容来源于stack exchange，提问作者user2377283