最直接的Java命令行菜单实现是用Scanner配合while(true)循环和switch分支,统一用nextLine()读输入并trim(),用Integer.parseInt()转数字且加try-catch防崩溃,退出设为"0"或"quit";菜单逻辑应拆分为独立方法并传入Scanner,避免多处抢读;选项超5个时推荐用枚举绑定提示与行为;勿过早引入Spring Shell等框架,优先解决输入阻塞与状态残留问题。

用 Scanner 实现基础菜单循环
Java 命令行菜单最直接的实现方式是靠 Scanner 读取用户输入,配合 while(true) 循环和 switch 分支。关键不是“封装多漂亮”,而是先让输入不卡死、选项不跳过。
常见错误是调用 nextLine() 前残留了换行符,比如先用了 nextInt(),再 nextLine() 就会直接返回空字符串——这会导致菜单看似“跳过”输入。
- 统一用
nextLine()读所有输入,后续用Integer.parseInt()转数字 - 对解析失败加
try-catch,避免输入非数字导致程序崩溃 - 菜单退出条件建议显式设为输入
"0"或"quit",别依赖异常中断
Scanner scanner = new Scanner(System.in);
while (true) {
System.out.println("1. 查看用户");
System.out.println("2. 添加用户");
System.out.println("0. 退出");
System.out.print("请选择: ");
String input = scanner.nextLine().trim();
if ("0".equals(input)) break;
try {
int choice = Integer.parseInt(input);
switch (choice) {
case 1 -> System.out.println("显示用户列表...");
case 2 -> System.out.println("请输入用户名: " + scanner.nextLine());
default -> System.out.println("无效选项");
}
} catch (NumberFormatException e) {
System.out.println("请输入有效数字");
}
}
把菜单逻辑拆到独立方法里
硬编码在 main 里很快会失控。把每个菜单项对应的操作抽成 void 方法,比如 showUsers()、addUser(),main 只负责调度。这样改一个功能不影响其他分支,也方便后期加日志或权限校验。
注意:这些方法不应再操作 Scanner —— 输入应该由主循环统一读入、传参进去。否则多个方法抢读 System.in 会乱序。
立即学习“Java免费学习笔记(深入)”;
- 菜单方法签名建议统一为
void xxx(Scanner scanner),保持输入源可控 - 如果操作需要返回值(如用户ID),改用
int selectUserId(Scanner scanner)这类带返回值的方法 - 避免在子方法里写
scanner.close(),关流只在 main 最后做一次
用枚举管理菜单项和行为绑定
当菜单项超过 5 个,用数字 case 容易错位、难维护。用枚举把选项名、提示文本、执行动作绑在一起,既可读又类型安全。
Java 8+ 可以在枚举中定义抽象方法 execute(Scanner scanner),每个枚举常量实现自己的逻辑。这样新增菜单项只需加一行枚举,不用动 switch。
- 枚举名用大驼峰(如
SHOW_USERS),对应提示文字存在字段里,避免硬编码 - 遍历枚举用
MenuOption.values()动态打印菜单,删选项不用改打印逻辑 - 用户输入字符串匹配时用
Enum.valueOf(String),但要包住IllegalArgumentException
enum MenuOption {
SHOW_USERS("查看用户") {
void execute(Scanner s) { System.out.println("用户列表..."); }
},
ADD_USER("添加用户") {
void execute(Scanner s) { System.out.println("输入姓名: " + s.nextLine()); }
};
private final String label;
MenuOption(String label) { this.label = label; }
abstract void execute(Scanner scanner);
static MenuOption fromInput(String input) {
try { return valueOf(input.trim().toUpperCase()); }
catch (IllegalArgumentException e) { return null; }
}
}
为什么不要过早引入 Spring Shell 或 CLI 框架
Spring Shell 是为复杂交互式 CLI 设计的,自带命令发现、参数解析、自动帮助。但你的项目只是“简单菜单”,引入它会带来:编译依赖膨胀、启动变慢、配置文件增多、调试路径变长——而你真正需要的只是 30 行内可维护的循环 + 分支。
真正该警惕的是“输入阻塞”和“状态残留”。比如用户输错三次后没清屏,旧提示还堆在上面;或者某次操作抛了异常没重置 scanner 状态,下一轮读输入就出错。这些问题框架不帮你解决,得靠你控制好每次读取的边界和异常恢复点。
等菜单真要支持子菜单嵌套、历史命令、快捷键、国际化时,再评估是否升级。现在把 Scanner 用稳,比套框架重要得多。










