IntelliJ资源编辑器无法识别.properties文件的类引用

问题详情 #

在IntelliJ中打开基于libGDX框架的shattered-pixel-dungeon项目时，资源文件夹下的.properties文件所有条目被标记为未使用，且无法显示代码中的类引用，但这些资源实际已通过Messages.get()方法在代码中调用，示例代码如下：

@Override
public String info() {
    String info = desc();

    if (volume == 0){
        info += "\n\n" + Messages.get(this, "desc_water");
    } else {
        info += "\n\n" + Messages.get(this, "desc_heal");
    }

    if (isFull()){
        info += "\n\n" + Messages.get(this, "desc_full");
    }

    return info;
}

已尝试更新资源编辑器插件和IntelliJ本体，问题仍未解决。

解决方案 #

1. 确认资源目录标记 #

• 打开File > Project Structure > Modules，选中当前项目模块
• 切换到Resources标签页，确保.properties文件所在文件夹已被标记为Resources Root（显示蓝色文件夹图标）
• 若未标记，右键目标文件夹选择Mark Directory as > Resources Root

2. 配置自定义资源引用识别规则 #

由于项目使用Messages.get()而非IntelliJ默认的资源加载方法，需手动配置IDE识别该调用：

• 打开File > Settings > Editor > Inspections
• 搜索Unused declaration，展开后找到Properties files下的Unused property
• 点击右侧Configure，在Java标签页的Resource bundle access区域，添加自定义方法：
  • 方法签名填写项目中Messages.get()的完整路径，例如com.shatteredpixel.shatteredpixeldungeon.Messages.get(java.lang.Object, java.lang.String)
  • 选择第二个参数作为资源键的匹配位置（对应代码中如desc_water的资源名）

3. 清除缓存并重启IDE #

• 打开File > Invalidate Caches...
• 勾选Clear file system cache and local history，点击Invalidate and Restart

4. 检查libGDX插件状态 #

• 在Settings > Plugins中确认libGDX Plugin已安装
• 安装完成后重启IDE，让插件自动适配项目的资源加载逻辑

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