IDEA无法高亮关联项目Schema的.graphql文件如何解决？

问题场景 #

我在开发包含GraphQL Schema的项目时遇到以下问题：

• .graphqls Schema文件存储在独立目录，Java Maven模块的resources目录下存放.graphql查询文件
• 此前IDEA可高亮查询文件中的对象、函数等元素，但该功能已失效，仅通用GraphQL语法高亮正常
• 已安装GraphQL插件，Schema文件的所有功能均正常

可行解决步骤 #

• 标记GraphQL Schema目录为资源根目录
  找到.graphqls文件所在的目录，右键选择 Mark Directory as → Resources Root，让IDE明确识别该目录下的Schema文件为核心资源，确保查询文件能关联到Schema进行精准语法高亮。

• 检查IDEA文件类型关联设置
  打开File → Settings → Editor → File Types，找到GraphQL类型，确认.graphql和.graphqls扩展名都已添加到关联列表中，避免IDE将这些文件识别为普通文本文件。

• 清理IDE缓存并重启
  执行File → Invalidate Caches...，选择Invalidate and Restart，清理缓存后重启IDEA，这类语法关联失效的问题常能通过该操作修复。

• 重新加载Maven项目
  在IDEA右侧Maven面板中，选中对应模块，点击Reload Projects按钮，让IDE重新读取项目配置，重新建立Schema与查询文件的关联关系。

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