Java CLI 框架：最佳工具概览与比较

Java CLI 框架：打造强大的控制台应用

在 Java 中开发复杂的控制台应用不仅需要逻辑，还需要便捷的命令行界面 (CLI)。手动实现参数解析、选项处理、帮助信息输出等工作既耗时又容易出错。幸运的是，有一些成熟的 CLI 框架可以自动化这一过程。本文将详细解析三大主流工具：Picocli、JCommander 和 Spring Shell，并附有代码示例和选型建议。

1. Picocli — 现代且高性能

Picocli (https://picocli.info/) 是当今最流行的 Java CLI 框架。其关键优势在于基于注解的极简 API，以及对 Java、Kotlin、Groovy、Scala 的支持。该库无需外部依赖，并且可以为 Bash、Zsh 和 Fish 生成自动补全功能。

Picocli 的主要特性：

• 注解 @Command、@Option、@Parameters
• 自动生成帮助信息 (--help)
• 嵌套命令（子命令）
• 支持值类型（int、boolean、enum、LocalDate）
• 自定义转换器和验证器

Picocli 简单应用示例：

import picocli.CommandLine;import picocli.CommandLine.Command;import picocli.CommandLine.Option;import picocli.CommandLine.Parameters;

@Command(name = "greet", description = "向用户打招呼")public class GreetApp implements Runnable {

    @Option(names = {"-n", "--name"}, defaultValue = "世界", description = "要问候的名字")    private String name;

    @Option(names = {"-c", "--count"}, defaultValue = "1", description = "重复次数")    private int count;

    @Override    public void run() {        for (int i = 0; i < count; i++) {            System.out.println("你好, " + name + "!");        }    }

    public static void main(String[] args) {        int exitCode = new CommandLine(new GreetApp()).execute(args);        System.exit(exitCode);    }}

运行：

java GreetApp --name="Java 开发者" --count=3

输出：

你好, Java 开发者!你好, Java 开发者!你好, Java 开发者!

2. JCommander — 久经考验的经典

JCommander (https://jcommander.org/) 是一个成熟的库，拥有悠久的历史（自 2011 年起）。它也使用注解，但为复杂场景提供了更灵活的架构。JCommander 特别适合需要对解析和错误处理进行严格控制的项目。

JCommander 的关键特性：

• 注解 @Parameter，带有属性 names、required、description
• 通过 Commands 支持多级命令
• 内置参数验证器
• 可通过转换器使用任意类型

JCommander 示例：

import com.beust.jcommander.JCommander;import com.beust.jcommander.Parameter;import com.beust.jcommander.Parameters;

@Parameters(commandDescription = "计算器")public class Calculator {

    @Parameter(names = {"--a"}, description = "第一个数字", required = true)    private int a;

    @Parameter(names = {"--b"}, description = "第二个数字", required = true)    private int b;

    @Parameter(names = {"--op"}, description = "操作：add, sub, mul, div")    private String operation = "add";

    public void run() {        int result;        switch (operation) {            case "add": result = a + b; break;            case "sub": result = a - b; break;            case "mul