IntelliJ工具窗口插件图标路径无法找到问题求助

我之前也碰到过一模一样的问题！明明编辑器能识别图标、配置也能正常跳转，但运行起来就报路径找不到，大概率是资源打包或者加载逻辑的细节没处理好，给你几个排查和修复的方向：

• 检查资源文件的位置与打包配置
  首先确认你的icon.png是不是放在src/main/resources/icons/目录下？IntelliJ插件的资源文件必须放在resources目录内，不然打包时不会被包含到最终的jar包里。如果你的图标是放在src/main/java下面，赶紧移到resources里。
  另外还要检查构建脚本（Gradle/Maven）有没有正确包含资源目录：
  比如Gradle里要确保有这段配置：

  sourceSets {
      main {
          resources {
              srcDirs = ["src/main/resources"]
          }
      }
  }
  

  还要注意文件名的大小写，Linux/Mac环境下大小写敏感，别出现代码里写icon.png但实际文件是Icon.png的情况。

• 修正图标加载的代码逻辑
  直接用IconLoader.getIcon("icons/icon.png")有时候会因为类加载器上下文的问题找不到资源，建议改成带类上下文的重载方法，并且路径前加上斜杠（代表从resources根目录开始查找）：

  public interface PluginIcons {
      Icon EDIT_LOCATION_ICON = IconLoader.getIcon("/icons/icon.png", PluginIcons.class);
  }
  

• 排查plugin.xml的配置与缓存问题
  你当前的icon="PluginIcons.EDIT_LOCATION_ICON"写法是正确的，但IntelliJ的缓存可能会导致配置不生效。可以先临时改成直接写资源路径测试：

  <toolWindow ... icon="/icons/icon.png" ...>
  

  如果直接写路径能正常显示，再改回引用PluginIcons的方式，然后清理IntelliJ缓存：File -> Invalidate Caches... -> Invalidate and Restart，重启后应该就能正常识别了。

• 验证打包后的插件结构
  可以先构建插件包，然后解压生成的jar文件，检查里面是否存在icons/icon.png，并且位置在jar的根目录下（和classes文件夹同级）。如果找不到这个文件，说明资源没被正确打包，回到第一步重新检查资源目录的配置。

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