Groovy脚本中如何安全解析命令行参数，处理可选参数？

核心疑问解答 #

是的，每次访问args数组的索引前必须检查其长度。Groovy的args本质是Java数组，直接访问超出数组长度的索引会抛出IndexOutOfBoundsException，因此必须先确认索引在有效范围内。

你的代码问题分析 #

原代码中if (args.size() == 1)的逻辑完全错误：当参数数量为1时，尝试获取args[1]必然触发越界异常。正确的逻辑应该是先判断参数数量是否满足最低要求（至少1个），再根据实际长度处理可选参数。

解决方案 #

1. 基础长度检查（直观易懂）

def local = ""
def date = null

// 验证最低参数要求
if (args.size() < 1) {
    println "Incorrect parameters!! 至少需要传入1个参数"
    System.exit(0)
}

// 必传参数赋值
local = args[0]

// 可选参数判断赋值
if (args.size() >= 2) {
    date = args[1]
}

// 后续逻辑：根据date是否为null处理
if (date) {
    println "Local: ${local}, Date: ${date}"
} else {
    println "Local: ${local}, 未提供日期参数"
}

2. Groovy风格的简洁处理（利用List方法）

将数组转为List后，使用getOrDefault方法直接获取可选参数，无需手动判断长度：

def argsList = args as List

if (argsList.size() < 1) {
    println "Incorrect parameters!! 至少需要传入1个参数"
    System.exit(0)
}

def local = argsList[0]
def date = argsList.getOrDefault(1, null) // 索引1不存在时返回null

// 后续处理逻辑
println "Local: ${local}, Date: ${date ?: '未提供'}"

3. 解构赋值（Groovy特色写法）

通过给args补全默认值，直接解构赋值，代码更简洁：

// 如果args长度不足，后面补null，确保解构不会报错
def (local, date) = args + [null]

if (!local) { // 检查必传参数是否存在
    println "Incorrect parameters!! 至少需要传入1个参数"
    System.exit(0)
}

// 后续处理逻辑
println "Local: ${local}, Date: ${date ?: '未提供'}"

4. 复杂场景推荐：CliBuilder（Groovy自带工具）

如果后续需要支持带选项的参数（如--local、--date），或者需要自动生成帮助信息，推荐使用Groovy内置的CliBuilder：

def cli = new CliBuilder(usage: 'your-script.groovy <local> [date]')
cli.h(longOpt: 'help', '显示帮助信息')

def options = cli.parse(args)
if (!options) {
    System.exit(1)
}

// 处理帮助请求
if (options.h) {
    cli.usage()
    System.exit(0)
}

// 获取位置参数
def positionalArgs = options.arguments()
if (positionalArgs.size() < 1) {
    println "错误：必须传入local参数"
    cli.usage()
    System.exit(1)
}

def local = positionalArgs[0]
def date = positionalArgs.size() >= 2 ? positionalArgs[1] : null

// 后续处理逻辑
println "Local: ${local}, Date: ${date ?: '未提供'}"

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