JavaFX无FXML/SceneBuilder场景下CSS背景图片加载失败问题

核心原因：图片路径错误或子节点遮挡背景 #

其他CSS样式生效说明样式表加载正常，问题出在图片路径或者背景被覆盖上，按以下步骤排查：

1. 修正图片文件位置
   把16copia.jpg放到项目的src/main/resources目录下（Maven/Gradle项目标准资源目录），或者和你的style.css放在同一个目录里。不要把图片放在src/main/java下，这个目录是存放Java代码的，资源文件无法被正确打包访问。

2. 修改CSS中的图片路径
   如果图片和style.css同目录，直接用相对路径：

   .root{
       -fx-font-family: 'JetBrains Mono';
       -fx-font-size: 10px;
       -fx-background-image: url("16copia.jpg");
       -fx-background-repeat: no-repeat;
       -fx-background-size: cover; /* 用cover比stretch适配性更好，可选 */
       -fx-background-position: center center; /* 可选，让图片居中显示 */
   }
   

   如果图片放在resources/images子目录下，路径改成url("images/16copia.jpg")。

3. 解决子节点遮挡问题
   你的root是BorderPane，设置了center和bottom区域的子节点（displayView、calcView），如果这些子节点有默认背景色（比如白色），会把root的背景完全遮住。需要给这些子节点设置透明背景：

   .border-pane .center, .border-pane .bottom {
       -fx-background-color: transparent;
   }
   

   或者直接给你的自定义视图类设置透明，比如如果calcView是VBox：

   .vbox {
       -fx-background-color: transparent;
   }
   

4. 验证路径是否正确
   可以用代码打印资源加载状态，确认路径是否正确：

   // 在start方法中添加，检查图片是否能被找到
   URL imageUrl = getClass().getResource("/16copia.jpg");
   System.out.println("图片资源路径：" + imageUrl);
   

   如果输出null，说明路径不对，重新调整图片位置。

最终修改后的示例 #

CSS：

.root{
    -fx-font-family: 'JetBrains Mono';
    -fx-font-size: 10px;
    -fx-background-image: url("16copia.jpg");
    -fx-background-repeat: no-repeat;
    -fx-background-size: cover;
    -fx-background-position: center;
}
.button{
    -fx-base:lightblue;
}
.label {
    -fx-text-fill: lightblue;
}
/* 让子节点透明，露出root的背景 */
.border-pane > .center, .border-pane > .bottom {
    -fx-background-color: transparent;
}

主类代码保持原有加载样式表的方式即可：

public void start(Stage stage){
    stage.setTitle("Calculator App");
    genMenuBar();
    setFunctionality();

    Scene mainScene = new Scene(root, 300, 500);
    root.setBottom(calcView);
    root.setCenter(displayView);
    mainScene.getStylesheets().add("style.css");
    stage.setScene(mainScene);
    stage.show();
}

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