如何在PicoCLI中正确指定基本类型数组的默认值与选项值？

核心问题原因 #

你之前遇到的错误，本质是没正确配置数组的解析规则，以及对@Option的defaultValue属性用法理解有误——基本类型数组的defaultValue不能传单个拼接字符串，命令行输入也需要指定分隔符来拆分数值。

1. 命令行选项的正确配置 #

要让PicoCLI正确解析逗号分隔的数组输入，必须在@Option注解中添加split属性，指定数值之间的分隔符（比如逗号）。

示例代码（以double数组为例）：

import picocli.CommandLine;
import picocli.CommandLine.Option;

public class ArrayDemoCommand implements Runnable {
    // 指定split=","，告诉PicoCLI用逗号拆分输入的字符串
    @Option(names = "--multiple-values", split = ",", 
            description = "输入多个数值，用逗号分隔，例如：--multiple-values=0.1,0.2,0.3")
    private double[] values;

    @Override
    public void run() {
        if (values != null) {
            for (double val : values) {
                System.out.println("数值：" + val);
            }
        }
    }

    public static void main(String[] args) {
        new CommandLine(new ArrayDemoCommand()).execute(args);
    }
}

此时执行--multiple-values=0.10,0.20就能正确解析为double[] {0.10, 0.20}，不会再触发类型转换错误。

2. 设置数组的默认值 #

基本类型数组的默认值有两种正确配置方式：

方式一：直接字段初始化

直接给数组字段赋值默认值，这种方式直观易懂，PicoCLI会在未收到命令行参数时使用该默认值，收到参数则自动覆盖：

@Option(names = "--multiple-values", split = ",", 
        description = "输入多个数值，用逗号分隔，默认值为[0.5, 0.6, 0.7]")
private double[] values = {0.5, 0.6, 0.7};

方式二：通过@Option的defaultValue属性配置

注意：这里的defaultValue需要传字符串数组，每个元素对应一个数值的字符串形式，而不是把整个数组拼接成单个字符串（这是你之前报错的核心原因）。

示例：

@Option(names = "--multiple-values", split = ",", 
        defaultValue = {"0.5", "0.6", "0.7"},
        description = "输入多个数值，用逗号分隔，默认值: ${DEFAULT-VALUE}")
private double[] values;

PicoCLI会自动将字符串数组中的每个元素转换为对应的基本类型，生成默认数组。

3. 进阶：支持重复输入选项 #

如果需要同时支持“逗号分隔单次输入”和“多次输入选项”（比如--multiple-values=0.1 --multiple-values=0.2），可以添加multiValued = true属性：

@Option(names = "--multiple-values", split = ",", multiValued = true,
        defaultValue = {"0.5", "0.6"},
        description = "可多次输入选项，或用逗号分隔单次输入，默认值: ${DEFAULT-VALUE}")
private double[] values;

此时执行--multiple-values=0.1,0.2 --multiple-values=0.3，会得到合并后的数组[0.1, 0.2, 0.3]。

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