JavaFX中如何修改Button按钮的背景颜色

以下方案覆盖Java GUI开发最常用的两类技术栈，之前执行命令不生效基本都是踩了API默认配置的坑，对照对应场景调整即可。

Swing 实现（入门学习最常用场景） #

Swing的JButton默认UI渲染逻辑下不会主动绘制自定义背景，必须先开启不透明属性才能让设置的颜色生效，步骤如下：

• 初始化按钮后先调用setOpaque(true)，关闭组件透明属性，允许组件绘制自身背景
• 调用setBackground(Color 颜色实例)设置目标背景色
• 可选配置：如果不需要默认的立体边框，调用setBorderPainted(false)避免按钮边缘出现默认边框留白
• 所有UI操作必须放在Swing事件调度线程（EDT）中执行，否则会出现重绘不触发、修改不生效的问题

可直接运行的参考代码：

import javax.swing.*;
import java.awt.*;

public class ButtonColorTest {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame();
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(300, 150);

            JButton testBtn = new JButton("点击切换背景色");
            // 初始背景设为红色
            testBtn.setBackground(Color.RED);
            testBtn.setOpaque(true);
            testBtn.setBorderPainted(false);

            // 点击按钮切换为绿色
            testBtn.addActionListener(e -> {
                testBtn.setBackground(Color.GREEN);
            });

            frame.add(testBtn);
            frame.setLocationRelativeTo(null);
            frame.setVisible(true);
        });
    }
}

常见不生效原因 #

• 漏写setOpaque(true)：默认LookAndFeel下JButton该属性为false，组件不会绘制自定义背景，是初学者遇到最多的问题
• 在main主线程直接操作UI：Swing UI组件非线程安全，非EDT线程的UI修改不会稳定触发重绘
• 使用了第三方自定义LookAndFeel：这类皮肤会重写按钮绘制逻辑，需要用皮肤提供的专属API修改样式，原生setBackground方法会失效

JavaFX 实现 #

如果是JavaFX技术栈，直接通过组件Background属性或者CSS样式设置即可，不要混用Swing的API：

import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.Background;
import javafx.scene.layout.BackgroundFill;
import javafx.scene.layout.CornerRadii;
import javafx.scene.layout.StackPane;
import javafx.scene.paint.Color;
import javafx.stage.Stage;

public class JavaFxBtnTest extends Application {
    @Override
    public void start(Stage stage) {
        Button testBtn = new Button("点击切换背景色");
        // 初始红色
        testBtn.setBackground(new Background(new BackgroundFill(Color.RED, CornerRadii.EMPTY, Insets.EMPTY)));
        // 点击切换绿色
        testBtn.setOnAction(e -> {
            testBtn.setBackground(new Background(new BackgroundFill(Color.GREEN, CornerRadii.EMPTY, Insets.EMPTY)));
        });
        // 也可以用CSS写法更简洁：testBtn.setStyle("-fx-background-color: red;");
        StackPane root = new StackPane(testBtn);
        stage.setScene(new Scene(root, 300, 150));
        stage.show();
    }
    public static void main(String[] args) {
        launch(args);
    }
}

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