控制台项目初期不应分模块,建议前两周所有类平铺在一个包中;待核心流程跑通后再按职责切分,优先合并状态强耦合类;main()应避免裸while循环,改用命令解析+业务调用分离;状态统一由hallcontext单例管理并序列化持久化;windows下需统一编译、运行及ide终端编码为utf-8。

Java 控制台项目该不该分模块?
控制台项目不是不能分模块,而是过早抽象反而让 Main 变得难找、调试变慢。新手常把 GameHallSystem 拆成 UserService、RoomManager 等一堆类,结果每个类都只有 20 行,但启动逻辑散在三个地方,改个登录流程要跳四次文件。
建议:前两周只用一个包(如 com.example.hall),所有类平铺;等核心流程跑通(用户登录 → 创建房间 → 加入 → 开始游戏),再按职责切分。切分时优先合并「状态强耦合」的类,比如 Room 和 PlayerList 别硬拆——它们共用同一份在线玩家数组,分开传参反而容易不同步。
怎么组织 main() 和交互循环?
别写 while (true) { showMenu(); handleInput(); } 这种裸循环。它会让输入解析、业务调用、错误提示全挤在一块,加个新菜单项就得改三处。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 用
Scanner读一行后立刻转成String[] tokens = input.trim().split("\s+", 2),第一个是命令(如"login"),第二个是参数(如"alice 123456") - 命令分发用
switch (tokens[0]),每个 case 只做「解析参数 + 调用业务方法」,不处理输出或异常细节 - 所有提示文字(包括错误)统一从
MessageBundle类里取,避免字符串散落各处;比如MessageBundle.get("login.success")
用户登录和房间状态怎么存才不翻车?
控制台项目最容易踩的坑:用 static List<user></user> 存用户,用 static Map<string room></string> 存房间,结果退出程序数据就丢,重启后所有人“复活”——这不是持久化,是幻觉。
现阶段真实需求其实是:关掉程序再重开,能恢复上次的房间列表(哪怕没人在线)。所以:
- 不要用
static当数据库,改用单例HallContext类封装全部运行时状态 - 每次创建/关闭房间后,自动把
HallContext.getRooms()序列化到rooms.json(用ObjectMapper或手写简单 JSON 字符串) - 启动时优先加载
rooms.json,加载失败才初始化空列表——这样即使 JSON 格式错,也不会卡死在启动阶段
注意:Room 类里别存 Scanner 或 System.out 这类 IO 对象,它们不能序列化。
为什么 Console 的编码问题总在 Windows 上爆发?
因为 Windows 控制台默认用 GBK,而 Java 源文件通常保存为 UTF-8,导致中文菜单显示成乱码,或者 scanner.nextLine() 读不到你输的中文用户名。
解决方式很直接:
- 编译时加参数:
javac -encoding UTF-8 *.java - 运行时强制指定控制台编码:
java -Dfile.encoding=UTF-8 com.example.hall.Main - 如果用 IDE,检查两个地方:项目编码设为
UTF-8,终端(Terminal)的编码也设为UTF-8(IntelliJ 在Settings > Tools > Terminal)
没配对这三项,哪怕代码里写了 System.setProperty("file.encoding", "UTF-8") 也没用——JVM 启动后才读这个属性,控制台输入通道早就按 GBK 打开了。
结构设计最麻烦的从来不是怎么分包,而是哪部分状态该跨进程保留、哪部分该每次启动重建。比如用户密码可以明文存在内存里(反正控制台没网络),但房间 ID 必须全局唯一且重启不重复——这时候就得在 Room 构造时读一个本地计数器文件,而不是用 new Random().nextInt()。











