JavaFX原生打包.exe自定义图标无效，系统找不到.ico文件求助

一、先查.ico文件本身 #

• 必须是标准Windows ICO格式：得包含16x16、32x32、48x48、256x256这些常用尺寸，而且是32位带Alpha通道的，不然系统可能识别不了，或者透明效果出问题
• 路径不能踩坑：别用中文、空格或特殊字符，比如C:\my-project\icons\app.ico就没问题，C:\我的项目\图标\app.ico大概率出错
• 直接验证文件：用Windows资源管理器打开.ico，确认所有尺寸的图标都能正常显示，排除文件损坏

二、核对javafx-maven-plugin的pom.xml配置 #

• 图标标签位置要对：必须放在<plugin>→<configuration>下面的<launcher>或<nativeImage>节点里，不同打包方式对应不同节点，示例正确配置：

  <plugin>
      <groupId>org.openjfx</groupId>
      <artifactId>javafx-maven-plugin</artifactId>
      <version>0.0.8</version>
      <configuration>
          <mainClass>com.example.Main</mainClass>
          <launcher>MyApp</launcher>
          <icon>src/main/resources/icons/app.ico</icon>
          <nativeImage>
              <icon>src/main/resources/icons/app.ico</icon>
          </nativeImage>
      </configuration>
  </plugin>
  

• 看打包日志：执行mvn javafx:jlink或mvn javafx:native时，盯着控制台输出，有没有“找不到图标文件”的警告或错误，这直接指向路径问题

三、检查Inno Setup的.iss文件 #

• 路径配置要准确：SetupIconFile是安装程序的图标，IconFilename是生成的快捷方式图标，示例：

  [Setup]
  SetupIconFile=C:\my-project\target\app.ico
  
  [Icons]
  Name: "{group}\MyApp"; Filename: "{app}\MyApp.exe"; IconFilename: "{app}\app.ico"
  

• 确保图标被复制到输出目录：maven打包后去target或安装目录里找.ico文件，要是没有，就得在pom.xml加资源复制配置，把图标拷过去：

  <build>
      <resources>
          <resource>
              <directory>src/main/resources/icons</directory>
              <includes>
                  <include>app.ico</include>
              </includes>
              <targetPath>icons</targetPath>
          </resource>
      </resources>
  </build>
  

• 别用模糊的相对路径：Inno Setup的相对路径是相对于.iss文件的，要么用绝对路径，要么用{src}变量指向项目根目录

四、排除系统缓存和环境干扰 #

• 清Windows图标缓存：系统会缓存旧图标，即使文件更新了也可能显示错，重启资源管理器或者跑命令ie4uinit.exe -show刷新
• 每次打包前删target目录：避免旧文件混在里面干扰
• 用管理员权限打包：有些路径权限不够，会导致文件读不到或复制失败

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