JavaFX游戏重构：单主类管理Stage与Scene是否为最佳实践？

架构方案分析与最优选择 #

你提到的两种方案的问题 #

• 方案一：主类统一管理Stage/Scene，逻辑类调用主类方法改界面
  这种方式会让主类快速膨胀成“上帝类”，游戏逻辑和UI代码高度耦合。后期修改游戏规则或调整界面布局时，需要在同一个类里改动大量代码，维护难度陡增；而且测试游戏逻辑时必须启动JavaFX环境，无法单独做单元测试。

• 方案二：每个逻辑类自行管理Scene/Stage，传递Stage实例
  这种设计违反了单一职责原则——游戏逻辑类的核心职责是处理游戏规则、状态，不该关心UI组件（Stage/Scene）的创建和管理。多个逻辑类操作同一个Stage还容易导致界面状态混乱，比如多个类同时切换Scene引发的冲突。

推荐的分层架构（MVC/MVP变种） #

JavaFX开发的通用最佳实践是采用分层解耦的架构，将代码分为三层：

1. 模型层（Model）：纯游戏逻辑实现，完全剥离JavaFX依赖。把原来命令行版本的游戏逻辑迁移到这里，只处理游戏状态、规则计算、数据存储等，不包含任何UI相关代码。这层可以独立编写单元测试，无需启动JavaFX环境。
2. 视图层（View）：JavaFX UI组件的定义与管理，由你的主类MoUD_FX作为入口，负责创建Stage、Scene，以及按钮、文本框等交互组件。视图只做两件事：展示模型传递的数据，将用户操作（比如按钮点击）转发给控制器。
3. 控制器层（Controller）：作为模型和视图的中间层，接收视图的用户操作事件，调用模型的逻辑方法，然后将模型返回的结果（比如游戏状态变化、提示信息）通知视图更新界面。控制器可以通过观察者模式、回调接口或者自定义事件，实现模型与视图的解耦——模型不需要知道视图的存在，只需要在状态变化时发出通知。

具体实现建议 #

• 不要让逻辑类直接管理Scene：把不同的游戏界面（主菜单、游戏界面、结算界面等）做成独立的Pane或Scene，由主类或专门的视图管理器负责切换。每个界面对应一个控制器，处理该界面的交互逻辑。
• 避免硬编码依赖：比如不要让模型类直接调用MoUD_FX的UI方法，而是在模型中定义状态变化的监听器接口，控制器实现该接口并注册到模型，当模型状态改变时自动通知控制器，再由控制器更新视图。

System.out重定向的处理 #

如果需要保留原有代码中System.out.println的输出到GUI文本框，可以通过自定义OutputStream实现，但要注意JavaFX的UI操作必须在JavaFX应用线程中执行：

import javafx.application.Platform;
import javafx.scene.control.TextArea;
import java.io.IOException;
import java.io.OutputStream;
import java.io.PrintStream;

public class GUIOutputStream extends OutputStream {
    private final TextArea outputArea;
    private final StringBuilder buffer = new StringBuilder();

    public GUIOutputStream(TextArea outputArea) {
        this.outputArea = outputArea;
    }

    @Override
    public void write(int b) throws IOException {
        buffer.append((char) b);
        // 遇到换行符时更新UI
        if (buffer.toString().endsWith("\n")) {
            Platform.runLater(() -> {
                outputArea.appendText(buffer.toString());
                buffer.setLength(0);
            });
        }
    }
}

// 在主类中初始化
public class MoUD_FX extends Application {
    @Override
    public void start(Stage primaryStage) {
        TextArea gameOutput = new TextArea();
        // 重定向System.out到文本框
        System.setOut(new PrintStream(new GUIOutputStream(gameOutput)));

        // 其他UI初始化代码...
        Scene scene = new Scene(new VBox(gameOutput), 800, 600);
        primaryStage.setScene(scene);
        primaryStage.show();
    }
}

不过这只是临时过渡方案，长远来看建议改造原有逻辑，让模型通过事件或回调传递需要展示的信息，彻底摆脱对System.out的依赖，这样更符合分层架构的设计原则。

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