IntelliJ Erlang插件宏未解析及include_lib文件找不到问题求助

环境配置 #

• IntelliJ IDEA 2022.2.2
• Erlang插件 0.11.1144
• SDK：Erlang OTP 25，erts-13.0
• 导入项目：https://github.com/FlowForwarding/enetconf

问题描述 #

鼠标悬停?debugMsg、?assertEqual等宏时，IDE提示Unresolved macros '?debugMsg'、Unresolved macros '?assertEqual'，无法进行代码遍历操作。

初步排查 #

代码中已通过-include_lib引入对应头文件，但悬停以下代码行时，IDE提示Unresolved include_lib: file not found，推测头文件未被正确识别：

-include_lib("eunit/include/eunit.hrl").
-include_lib("xmerl/include/xmerl.hrl").

解决步骤 #

• 校验SDK路径配置：打开File > Project Structure > SDKs，选中已配置的Erlang SDK，确认路径指向Erlang OTP 25的安装根目录，而非仅erts-13.0子目录。SDK需包含完整的OTP库文件，才能正确解析include_lib引用。
• 重建项目索引：通过File > Invalidate Caches...选择Invalidate and Restart，强制IDE清除旧索引并重新构建，多数路径识别问题可通过此操作解决。
• 手动添加头文件依赖：打开File > Project Structure > Modules，选中项目模块切换到Dependencies标签，点击+选择JARs or directories，分别添加OTP安装目录下的lib/eunit/include和lib/xmerl/include目录，将依赖类型设置为Provided。
• 适配插件版本：Erlang插件0.11.1144与IntelliJ IDEA 2022.2.2可能存在兼容性问题，进入Settings > Plugins，更新Erlang插件至适配2022.2.x版本的最新稳定版，或回退至插件官方标注兼容该IDE版本的旧版本。

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