Picocli编程式注册子命令单元测试失败，求正确测试写法

问题背景 #

在Picocli框架中，子命令支持声明式和编程式两种注册方式，业务代码中两种方式都能正常运行，但原有单元测试仅能通过声明式注册的版本，对编程式注册的版本执行失败。

原有测试代码：

@Test
void testApp() {
    App app = new App();
    CommandLine commandLine = new CommandLine(app);
    int code = commandLine.execute("sub1", "param1");
    assertEquals(0, code);
}

编程式注册的App类：

@CommandLine.Command(name = "foo")
public class App {
  public static void main( String[] args )
  {
      CommandLine commandLine = new CommandLine(new App())
        .addSubcommand("sub1", new App.Sub());
      System.exit(commandLine.execute(args));
  }
  @CommandLine.Command(name = "sub1", description = "sub1")
  public static class Sub implements Runnable {
    @CommandLine.Parameters
    public String [] params;
    @Override
    public void run() {
        System.out.println("Sub " + params[0]);
    }
  }
}

失败原因 #

原有测试代码仅初始化了主命令的CommandLine实例，但编程式注册子命令的操作只在App的main方法中执行，测试代码未复刻这一步骤，导致CommandLine实例中未注册sub1子命令，执行时无法识别该命令，最终测试失败。

修正方案 #

方案1：测试中手动注册子命令 #

直接在测试代码中添加子命令注册逻辑，与main方法保持一致：

@Test
void testApp() {
    App app = new App();
    // 复刻main方法中的编程式注册逻辑
    CommandLine commandLine = new CommandLine(app)
            .addSubcommand("sub1", new App.Sub());
    int code = commandLine.execute("sub1", "param1");
    assertEquals(0, code);
}

方案2：抽离注册逻辑复用（推荐） #

将子命令注册逻辑从main方法中抽离为独立方法，供main和测试复用，避免重复代码：

修改后的App类：

@CommandLine.Command(name = "foo")
public class App {
    // 抽离公共注册逻辑
    public CommandLine buildCommandLine() {
        return new CommandLine(this)
                .addSubcommand("sub1", new Sub());
    }

    public static void main(String[] args) {
        CommandLine commandLine = new App().buildCommandLine();
        System.exit(commandLine.execute(args));
    }

    @CommandLine.Command(name = "sub1", description = "sub1")
    public static class Sub implements Runnable {
        @CommandLine.Parameters
        public String[] params;

        @Override
        public void run() {
            System.out.println("Sub " + params[0]);
        }
    }
}

对应的测试代码：

@Test
void testApp() {
    App app = new App();
    // 复用公共注册方法
    CommandLine commandLine = app.buildCommandLine();
    int code = commandLine.execute("sub1", "param1");
    assertEquals(0, code);
}

说明 #

方案2的优势在于保持注册逻辑的单一性，后续修改子命令注册规则时，只需修改buildCommandLine方法即可，无需同时修改main和测试代码，降低维护成本。

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