QtCreator自定义QML导入路径提示目录不存在 导入QML类型却显绿色

• Qt Creator的QML语法识别逻辑与构建校验逻辑相互独立：语法高亮（即你观察到的类型名称显示为绿色）仅静态扫描qmldir文件的类型声明和配置的搜索路径，只要类型在qmldir中存在声明就会被识别；而构建阶段的路径校验会严格检查导入路径对应的物理目录或qrc虚拟路径是否真实存在，二者逻辑不共通，因此会出现类型可识别但路径报错的矛盾现象。
• 导入路径与资源映射不匹配：QGroundControl构建时优先从qrc资源文件加载QML组件，若你import语句填写的是本地文件系统路径而非qrc对应的虚拟路径，构建阶段就会判定路径无效。
• qmldir存放层级与导入路径不匹配：若qmldir存放在custom/controls/目录下，但import语句仅声明import custom 1.0，未对应到qmldir所在的层级，也会触发路径无效报错。
• Qt Creator项目缓存未更新：运行updateqrc.py更新资源配置后，旧的项目缓存仍被Qt Creator调用，导致构建层读取的还是之前的资源结构。

1. 校验qmldir配置与存放位置
   qmldir必须和CustomHorizontalSlider.qml放在同级目录下，内容参考如下：

module Custom.Controls
CustomHorizontalSlider 1.0 CustomHorizontalSlider.qml

2. 修正import路径写法
   若你的自定义控件存放在源码的custom/qml/Custom/Controls目录下，对应custom.qrc中的虚拟路径为qrc:/Custom/Controls/，在调用该控件的QML文件中导入语句需写为import Custom.Controls 1.0，不要填写本地文件系统的绝对/相对路径。
3. 配置Qt Creator的QML导入搜索路径
   打开Qt Creator侧边栏项目->构建&运行->对应构建套件的QML_IMPORT_PATH配置项，添加你自定义QML文件所在的本地源码路径（例如[项目根目录]/custom/qml），需同时为Debug、Release构建配置添加该路径。
4. 清除缓存重新构建
   关闭Qt Creator，删除项目根目录下的build文件夹、.qtc_clangd目录、.user后缀的缓存配置文件，重新打开项目执行qmake后再构建即可消除报错。
5. 校验qrc资源路径
   打开custom.qrc文件，确认CustomHorizontalSlider.qml和qmldir的资源路径与你导入的模块路径完全匹配，例如qrc中文件路径为/Custom/Controls/CustomHorizontalSlider.qml，则模块导入路径必须与Custom/Controls层级对应。

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