如何解决JavaFX中GridPane出现无法消除的“幽灵线”问题？

问题原因 #

你遇到的“幽灵线”是JavaFX布局的经典渲染问题，本质是浮点坐标抗锯齿采样误差：你使用百分比计算单元格宽高时，每个单元格的最终尺寸会出现小数位，JavaFX默认布局在非整数像素对齐时，相邻单元格的缝隙会透出底层容器的背景色，看起来就像无法消除的细线。

解决方案 #

按优先级选择以下方法即可解决：

1. 开启GridPane像素对齐
   在Controller的Grid方法中，设置Hgap和Vgap的代码后添加一行：

wellsGridPane.setSnapToPixel(true);

这个属性会强制布局系统将所有单元格坐标对齐到整数像素，从根源避免小数缝隙产生，90%以上的同类问题都可以通过这个配置解决。

2. 替换百分比宽高为固定像素计算
   你已经在setStage方法中锁死了窗口的宽高，GridPane的可用尺寸是固定的，直接计算固定宽高替代百分比计算即可完全避免浮点误差：

// 替换原来的百分比约束代码
int gridTotalWidth = 816; // 窗口宽1016 - 左右Anchor偏移各100
int gridTotalHeight = 589; // 窗口高789 - 上下Anchor偏移各100
for (int i = 0; i < 8; i++) {
    ColumnConstraints colConst = new ColumnConstraints();
    colConst.setPrefWidth(gridTotalWidth / 8);
    wellsGridPane.getColumnConstraints().add(colConst);
}
for (int i = 0; i < 6; i++) {
    RowConstraints rowConst = new RowConstraints();
    rowConst.setPrefHeight(gridTotalHeight / 6);
    wellsGridPane.getRowConstraints().add(rowConst);
}

3. 兜底兼容方案
   如果以上两种方法都不生效，可以直接将GridPane的背景色设置为和单元格内容的主色一致，就算有缝隙透出也和周围颜色无差异，肉眼不可见：

wellsGridPane.setStyle("-fx-background-color: #000000;"); // 颜色替换为你图片的主色即可

额外代码优化提示 #

你当前加载图片的路径src\resources\image.jpg在项目打包为Jar包后会失效，建议替换为类加载器读取资源的写法：

img = new Image(getClass().getResource("/resources/image.jpg").toExternalForm(), 100, 100, true, false);

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