使用getopt的Bash脚本：--被误识别为--usage的解决方案咨询

问题 #

编写了一个使用getopt解析命令行参数的Bash脚本，执行bash script.sh -a --apple -b --banana carrot durian时，脚本错误打印使用说明而非正常执行逻辑。问题核心是位置参数前的--被--usage分支误捕获，想知道除了将--)分支放在case代码块顶部外的其他解决方案。

原脚本核心逻辑：

SHORT_OPTIONS="?::,h::,a::,b::"
LONG_OPTIONS="help::,usage::apple::,banana::"
ARGV="$(getopt -o $SHORT_OPTIONS -l $LONG_OPTIONS -- "$@")"

eval set -- "$ARGV"

APPLE=false
BANANA=false
CARROT=false
DURIAN=false

while [[ $# > 0 ]]; do
  case "$1" in
    -?)
      ;&
    -h)
      ;&
    --help)
      ;&
    --usage)
      echo "Usage:"
      echo "  script.sh <args> ..."
      echo "Arguments:"
      echo "  [-? | -h | --help | --usage]:  Show this usage text"
      echo "  [-a | --apple]:  Process an apple"
      echo "  [-b | --banana]:  Process a banana"
      echo "  carrot:  Process the carrot"
      echo "  durian:  Process the durian"
      break;;
    -a)
      ;&
    --apple)
      APPLE=true
      shift 2;;
    -b)
      ;&
    --banana)
      BANANA=true
      shift 2;;
    *)
      case "$1" in
        carrot)
          CARROT=true
          ;;
        durian)
          DURIAN=true
          ;;
        *)
          ;;
      esac
      shift 1;;
  esac
done

# 后续逻辑省略...

根本原因 #

脚本的getopt选项定义存在错误：

1. 长选项LONG_OPTIONS中，usage::apple::未用逗号分隔，导致--apple被识别为--usage的可选参数，触发usage分支。
2. 短选项SHORT_OPTIONS使用逗号分隔，不符合getopt短选项的语法要求（短选项无需逗号，直接拼接）。
3. 带可选参数的选项处理逻辑错误，shift 2会强制跳过下一个参数，无论其是否为选项参数。

解决方案 #

1. 修正选项定义（最关键） #

调整短选项和长选项的格式，确保分隔符正确：

• 短选项：去掉逗号，改为SHORT_OPTIONS="?:h::a::b::"
• 长选项：用逗号分隔每个选项，改为LONG_OPTIONS="help::,usage::,apple::,banana::"

2. 优化选项处理逻辑 #

针对带可选参数的选项，检查下一个参数是否为合法选项，避免错误shift；同时用exit 0代替break，触发usage后直接退出脚本，避免后续错误执行。

3. 完善位置参数处理 #

即使不将--)分支放在顶部，也可以通过明确的参数校验避免误匹配，同时单独处理--后的位置参数，确保逻辑清晰。

修正后的完整脚本：

SHORT_OPTIONS="?:h::a::b::"
LONG_OPTIONS="help::,usage::,apple::,banana::"
ARGV="$(getopt -o "$SHORT_OPTIONS" -l "$LONG_OPTIONS" -- "$@")"

eval set -- "$ARGV"

APPLE=false
BANANA=false
CARROT=false
DURIAN=false

while [[ $# -gt 0 ]]; do
  case "$1" in
    -?|--help|--usage|-h)
      echo "Usage:"
      echo "  script.sh <args> ..."
      echo "Arguments:"
      echo "  [-? | -h | --help | --usage]:  Show this usage text"
      echo "  [-a | --apple]:  Process an apple"
      echo "  [-b | --banana]:  Process a banana"
      echo "  carrot:  Process the carrot"
      echo "  durian:  Process the durian"
      exit 0
      ;;
    -a|--apple)
      APPLE=true
      # 检查下一个参数是否为选项，非选项则作为可选参数跳过
      if [[ "$2" != -* ]]; then
        shift
      fi
      shift
      ;;
    -b|--banana)
      BANANA=true
      if [[ "$2" != -* ]]; then
        shift
      fi
      shift
      ;;
    --)
      # 处理--之后的所有位置参数
      shift
      while [[ $# -gt 0 ]]; do
        case "$1" in
          carrot) CARROT=true ;;
          durian) DURIAN=true ;;
        esac
        shift
      done
      break
      ;;
    *)
      # 处理未被--包裹的位置参数
      case "$1" in
        carrot) CARROT=true ;;
        durian) DURIAN=true ;;
      esac
      shift
      ;;
  esac
done

if [[ "$APPLE" == true ]]; then
  echo "I have an apple"
fi

if [[ "$BANANA" == true ]]; then
  echo "I have a banana"
fi

if [[ "$CARROT" == true ]]; then
  echo "Yay!  I got my carrot."
else
  echo "ERROR:  I need a carrot"
  exit 1
fi

if [[ "$DURIAN" == true ]]; then
  echo "Yay!  I got my durian."
else
  echo "ERROR:  I need a durian"
  exit 1
fi

其他可选方案 #

• 使用getopts替代getopt：如果脚本无需处理长选项，getopts语法更简单，不易出错。
• 增加参数合法性校验：在进入每个分支前，检查参数是否完全匹配，避免部分匹配导致的误触发。

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