GitHub Actions中basename报extra operand错误排查求助

问题场景 #

我编写了一款Shell脚本，基于cmd/目录下的子目录名称动态打包压缩二进制文件。本地使用zsh运行脚本时一切正常，但在GitHub Actions的bash环境中执行时，出现以下错误：

basename: extra operand ‘./cmd/get-reminders/’

错误出现在收集目录名到数组的prepare函数中，函数代码如下：

prepare() {
    for d in "./cmd/*/"
    do 
        handlers+=($(basename $d))
    done
}

错误本质 #

这个错误的核心是bash与zsh对引号内通配符的处理逻辑不同，加上未正确引用变量导致参数传递异常：

1. bash中引号会阻止通配符（*）展开，for d in "./cmd/*/"会把字面量字符串./cmd/*/直接赋值给循环变量d，而非遍历cmd/下的子目录。
2. 执行basename $d时，$d未加引号，bash会对其做路径展开，将./cmd/*/替换为所有匹配的子目录路径（比如./cmd/get-reminders/ ./cmd/another/），这些路径会被作为多个参数传给basename。而basename默认仅支持单个路径参数，多参数传入就会触发"extra operand"错误。

本地zsh与GitHub Actions bash的差异 #

• zsh默认会对引号内的通配符做展开处理，for d in "./cmd/*/"会自动遍历cmd/下的每个子目录，每次循环d都是单个目录路径，basename $d仅传入一个参数，因此不会报错。
• GitHub Actions使用的bash遵循POSIX标准，引号会严格阻止通配符展开，再加上未引用变量导致的参数拆分，最终触发了错误。

修复方案 #

修改prepare函数，确保通配符正确展开且变量被正确引用：

prepare() {
    # 去掉引号让bash展开通配符，遍历cmd下的所有子目录
    for d in ./cmd/*/
    do 
        # 给变量和命令替换结果加引号，避免空格等特殊字符导致的问题
        handlers+=("$(basename "$d")")
    done
}

内容的提问来源于stack exchange，提问作者Stephan Bakkelund Valois