JavaFX GridPane中图片无法显示（按钮正常）的技术求助

我来帮你搞定这个图片不显示的问题，大概率是图片资源的加载路径出了问题，咱们一步步分析解决：

问题根源 #

你代码里用了new Image("File:empty.png")，这种方式是直接加载本地文件系统的图片，但如果你的图片是项目内的资源文件，这种写法很容易因为程序运行的工作目录不对，导致找不到文件。JavaFX加载项目内资源更推荐用类路径加载，这才是更稳定可靠的方式。

解决方案步骤 #

1. 确认图片文件的存放位置 #

• 如果是Maven/Gradle项目：把图片放到src/main/resources目录下（这个目录会被自动加入类路径，打包后也能正常访问）。
• 如果是普通Java项目：要么把图片放在项目根目录，要么和Main类放在同一个sample包下。

2. 修正Image的加载代码 #

根据图片位置选择对应的加载方式：

• 图片在resources根目录：用类路径根路径加载，注意前面的斜杠：

  Image empty = new Image(getClass().getResourceAsStream("/empty.png"));
  

• 图片和Main类同包（sample包）：直接用相对路径（不用斜杠）：

  Image empty = new Image(getClass().getResourceAsStream("empty.png"));
  

• 如果确实要加载本地外部图片：确保路径正确，比如绝对路径File:/Users/yourname/empty.png，或者相对路径要匹配程序运行时的工作目录（但这种方式不推荐，打包后路径容易混乱）。

3. 修正后的完整代码 #

package sample;

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.image.Image;
import javafx.scene.image.ImageView;
import javafx.scene.layout.GridPane;
import javafx.stage.Stage;

public class Main extends Application {
    @Override
    public void start(Stage primaryStage) throws Exception{
        GridPane gridPane = new GridPane();
        
        // 假设empty.png在src/main/resources目录下，用类路径加载
        Image empty = new Image(getClass().getResourceAsStream("/empty.png"));
        ImageView view = new ImageView(empty);
        
        Button button = new Button("Some Button");
        
        GridPane.setRowIndex(button, 0);
        GridPane.setColumnIndex(button, 1);
        GridPane.setRowIndex(view, 0);
        GridPane.setColumnIndex(view, 0);
        
        gridPane.getChildren().addAll(view, button);
        
        primaryStage.setTitle("Hello World");
        primaryStage.setScene(new Scene(gridPane, 561, 400));
        primaryStage.show();
    }
    public static void main(String[] args) {
        launch(args);
    }
}

额外排查技巧 #

• 可以先打印资源路径，确认文件是否能被找到：

  System.out.println(getClass().getResource("/empty.png"));
  

  如果输出null，说明路径或者文件位置不对，要调整。
• 注意文件名的大小写！JavaFX在类路径加载时是大小写敏感的，比如Empty.png和empty.png是两个不同的文件。
• 确认图片格式是JavaFX支持的（PNG、JPG、GIF等都没问题，WebP这类格式不支持）。

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