如何配置IntelliJ使其正确识别XQuery导入的模块引用

1. 标记XQuery源码根目录 #

• 打开IDEA顶部菜单File > Project Structure > Modules，选中当前项目对应的模块
• 在右侧文件树中找到本地XQuery文件的根目录c:/project/src/main/xquery，右键点击后选择Mark as > Sources，标记为源码根目录。

2. 配置XQuery模块路径映射 #

• 打开IDEA设置页：File > Settings > Languages & Frameworks > XQuery / XSLT > XQuery
• 首先确认Enable module reference resolution（启用模块引用解析）选项已勾选
• 找到Module Path Mappings（模块路径映射）配置区，点击添加按钮新增一条规则：
  • 服务器路径前缀：/code/test/
  • 本地路径前缀：c:/project/src/main/xquery/
    该规则会让插件自动将导入语句中at属性的服务器路径，按前缀替换成本地路径查找对应文件。

3. 校验命名空间一致性 #

• 打开testRecord.xqy文件，确认头部的模块声明和导入语句的命名空间完全一致，示例：
  import module namespace testRecord = "testRecord.xqy" at "/code/test/testRecord.xqy"
  对应模块头部必须为：

  module namespace testRecord = "testRecord.xqy";
  

  插件会同时校验命名空间URI和文件路径，二者完全匹配才能触发跳转。

4. 重建索引生效 #

• 执行顶部菜单File > Invalidate Caches...，勾选Clear file system cache and local history，点击Invalidate and Restart
• 重启IDEA后等待项目索引重建完成，即可正常跳转模块声明。

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