在Java里如何编写控制台菜单程序_Java项目结构设计说明

控制台菜单本质是循环读取输入、匹配选项、执行对应逻辑，核心用Scanner读取后以if-else或switch分发，需避免nextInt()后接nextLine()的换行符陷阱，推荐统一用nextLine()配合Integer.parseInt()并捕获异常。

用 Scanner 读取用户输入并做分支判断

控制台菜单本质是循环读取输入、匹配选项、执行对应逻辑。核心是用 Scanner 读取一行字符串或数字，再用 if-else 或 switch 分发。注意别直接用 nextInt() 后跟 nextLine() ——前者不消费换行符，会导致后者立刻返回空字符串，这是新手最常踩的坑。

推荐统一用 nextLine() 读入，再用 Integer.parseInt() 转整数（加 try-catch 捕获 NumberFormatException）：

Scanner sc = new Scanner(System.in);
String input = sc.nextLine().trim();
if (input.isEmpty()) continue;
try {
    int choice = Integer.parseInt(input);
    switch (choice) {
        case 1 -> System.out.println("执行功能A");
        case 2 -> System.out.println("执行功能B");
        case 0 -> System.out.println("退出"); break loop;
        default -> System.out.println("无效选项");
    }
} catch (NumberFormatException e) {
    System.out.println("请输入数字");
}

把菜单逻辑和业务逻辑拆到不同类里

别把所有代码堆在 Main 类里。典型结构是：一个 Menu 类负责显示选项、接收输入、跳转；多个 Service 类（如 UserServiceImpl、OrderService）封装具体操作；数据模型（User、Order）单独放 model 包。这样改某个功能时，只动对应 Service，菜单类几乎不用碰。

项目目录大致如下：

• src/main/java/com/example/app/Menu.java
• src/main/java/com/example/app/service/UserService.java
• src/main/java/com/example/app/model/User.java
• src/main/java/com/example/app/Main.java（只含 main 方法，new Menu().start()）

避免死循环卡住控制台

菜单必须有明确退出路径，且循环体里要有 continue 或 break 控制流。常见错误是把退出条件写在 while 判断里，但内部没更新控制变量，或者异常后没 continue 导致重复提示。

更稳妥的做法是用带标签的循环 + break 标签名：

menuLoop:
while (true) {
    displayOptions();
    String input = sc.nextLine().trim();
    if (input.equals("0")) {
        System.out.println("再见");
        break menuLoop;
    }
    handleChoice(input);
}

另外，别在菜单循环里做耗时操作（如读文件、连数据库），否则用户会觉得“卡住”。真要加载数据，提前在 Menu 构造时初始化好，或用懒加载。

中文输出乱码或输入识别失败

如果控制台显示方块或问号，大概率是编码不一致。Windows 默认是 GBK，而 Java 源文件通常存为 UTF-8。解决方

• 在 Scanner 初始化时显式指定编码：new Scanner(System.in, "UTF-8")（前提是终端支持 UTF-8）
• 更通用的做法：统一用 IDE 和运行环境设为 UTF-8（IntelliJ → File Encoding → Project Encoding 设为 UTF-8；Maven 编译插件加 UTF-8）

还有一种情况：用户输入了空格或全角数字（如“１”），parseInt 会抛异常。简单过滤可加 input.replaceAll("[^0-9]", "")，但要注意这会吞掉所有非数字字符——比如选项是 “1a” 就变成 “1”，可能误触发。

菜单看着简单，但输入处理、异常分支、编码适配、职责分离这几处，实际写的时候最容易反复调试。尤其是从 Windows 命令行切到 IntelliJ Terminal 或 Linux 终端时，编码和换行行为差异会突然暴露问题。