如何在Java Swing GUI桌面应用中实现深色与浅色模式切换

核心原因：Swing的LookAndFeel(LAF)样式更新默认仅对切换后新创建的组件生效，弹窗生效主界面不生效是因为主界面所有组件在切换主题前已经完成初始化渲染，没有触发样式更新逻辑。

• 切换主题后强制刷新所有已存在组件的UI
  调用SwingUtilities.updateComponentTreeUI()方法递归更新组件树样式，之后强制重绘界面，示例逻辑如下：

  // 切换主题逻辑执行完成后添加以下代码
  // 刷新主界面全量组件
  SwingUtilities.updateComponentTreeUI(MainFrame.getInstance());
  // 刷新所有已打开的顶层窗口（包括已弹出的对话框、弹窗等）
  for (Window win : Window.getWindows()) {
      SwingUtilities.updateComponentTreeUI(win);
  }
  // 强制重绘主界面避免渲染残留
  MainFrame.getInstance().repaint();
  MainFrame.getInstance().validate();
  

• 自定义组件适配LAF规则
  你代码中自定义的MenuBar、ToolBar如果硬编码了背景、文字颜色，LAF切换不会自动覆盖这些自定义样式，需要将写死的颜色值替换为从UIManager取值，示例如下：

  // 错误写法：硬编码颜色，不受LAF控制
  // setBackground(Color.WHITE);
  // 正确写法：从当前LAF取对应颜色变量
  setBackground(UIManager.getColor("ToolBar.background"));
  setForeground(UIManager.getColor("ToolBar.foreground"));
  

• 启动时预设主题要注意执行顺序
  如果你需要程序启动默认就加载指定主题，必须在所有Swing组件实例化之前完成LAF设置，同时所有Swing操作要放在事件调度线程中执行，避免线程安全问题，修改后的Main方法示例：

  import javax.swing.*;
  import view.MainFrame;
  
  public class Main {
      public static void main(String[] args) {
          SwingUtilities.invokeLater(() -> {
              // 第一步：先设置LAF，所有组件初始化之前执行
              try {
                  // 替换为你使用的明暗主题对应的LAF全类名即可
                  UIManager.setLookAndFeel("com.formdev.flatlaf.FlatDarkLaf");
              } catch (Exception e) {
                  e.printStackTrace();
              }
              // 第二步：再初始化主界面
              MainFrame mainFrame = MainFrame.getInstance();
          });
      }
  }
  

• 第三方LAF适配提示
  如果你使用FlatLaf、Substance之类的第三方LAF库，可以直接调用库提供的更新方法，简化操作，以FlatLaf为例：

  // 切换主题后直接调用即可自动刷新所有窗口
  FlatLaf.updateUI();
  

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