Bash shell的getopts在传入多参数时失效的问题排查与解决

问题根源 #

getopts的默认逻辑是：遇到第一个不带-前缀的非选项参数时，就会停止解析后续的选项。当你用./test.sh first second -a third调用脚本时，first和second是不带-的普通参数，getopts会直接终止循环，完全不会处理后面的-a选项，导致some_value未被赋值。

修复方法 #

根据你的需求，有两种常用的修复方式：

方式一：手动移除已知的前置非选项参数

如果你的脚本固定前两个参数是普通参数，在getopts循环前用shift命令把这两个参数移走，让后面的选项参数成为新的位置参数供getopts解析：

#!/usr/bin/env bash

first_arg=$1
second_arg=$2
shift 2  # 移除前两个位置参数，将后续参数前移

while getopts ":a:b" opt; do
    case $opt in
        a)
            echo "-a found"
            some_value=$OPTARG
            ;;
        b)
            echo "-b found"
            ;;
        \?)
            echo "Unknown flag"
    esac
done

echo "$some_value"

调用./test.sh first second -a third时，脚本会正确输出：

-a found
third

方式二：自动收集所有前置非选项参数

如果非选项参数的数量不固定，可以先循环收集所有不带-的前置参数，再用shift移除它们，最后处理选项：

#!/usr/bin/env bash

# 收集所有前置非选项参数
non_option_args=()
while [[ $# -gt 0 && ! "$1" =~ ^- ]]; do
    non_option_args+=("$1")
    shift
done

# 处理选项参数
while getopts ":a:b" opt; do
    case $opt in
        a)
            echo "-a found"
            some_value=$OPTARG
            ;;
        b)
            echo "-b found"
            ;;
        \?)
            echo "Unknown flag"
    esac
done

# 可按需使用收集到的非选项参数
echo "非选项参数列表: ${non_option_args[@]}"
echo "$some_value"

这种方式更灵活，不管前置普通参数有多少，都能正确处理后续的选项。

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