掌握Bash参数解析，打造强大脚本

命令行参数让你的Bash脚本变得灵活。如果Bash参数解析能力薄弱，每次需要不同的文件、主机或模式时，你就得手动编辑脚本内部的变量。

本指南将教你如何处理位置参数、使用getopts处理短选项，以及使用while/case循环处理长选项。目标是创建一个能及早拒绝错误输入并准确告知运行方式的脚本。

基础：位置参数

在讨论标志和命名选项之前，理解Bash如何处理简单的顺序参数至关重要。

变量	描述	示例（若以 `./script.sh foo bar` 调用）
`$0`	脚本本身的名称	`./script.sh`
`$1`, `$2`, ...	第一、第二个等位置参数	`foo`, `bar`
`$#`	位置参数的数量	`2`
`$@`	所有位置参数，视为独立字符串	`foo` `bar`
`$*`	所有位置参数，视为单个字符串	`foo bar`

示例：简单的位置检查

#!/bin/bash

if [ "$#" -ne 2 ]; then
    echo "用法: $0 <源文件> <目标目录>"
    exit 1
fi

SOURCE="$1"
DESTINATION="$2"

echo "正在将 $SOURCE 复制到 $DESTINATION..."
# cp "$SOURCE" "$DESTINATION"

使用 `getopts` 进行标准短选项解析

对于需要像 -v（详细模式）或 -f <文件> 这类选项的专业脚本，内置的 getopts 工具是纯Bash中最规范、最可靠的方法。它专门用于处理短（单字符）选项。

`getopts` 的工作原理

getopts 按顺序读取选项，将找到的选项赋值给指定的变量（通常是 OPT），并将任何参数（如果需要）的值放入变量 OPTARG 中。

选项字符串（OPTSTRING）： 定义有效选项。如果某个选项需要参数（例如 -f 文件名），则在字符后加冒号（:）。示例：vho: 允许 -v、-h 和需要值的 -o。
OPTIND： 一个内部Bash索引，跟踪下一个要处理的参数。它必须初始化为1（默认值，但在复杂脚本中有时会重置）。

实用的 `getopts` 模板

此模板处理三个选项：-v（标志）、-h（标志）和 -f（需要值的选项）。

#!/bin/bash

# --- 默认值 ---
VERBOSE=0
FILENAME="default.txt"

# --- 用法函数 ---
usage() {
    echo "用法: $0 [-v] [-h] [-f <文件>] <输入>"
    exit 1
}

# --- 参数解析循环 ---
while getopts ":vhf:" OPT; do
    case "$OPT" in
        v)
            VERBOSE=1
            echo "已启用详细模式。"
            ;;
        h)
            usage
            ;;
        f)
            # OPTARG 保存提供给 -f 的参数
            FILENAME="$OPTARG"
            echo "输出文件名设置为: $FILENAME"
            ;;
        \?)
            # 处理无法识别的选项
            echo "错误: 无效选项 -$OPTARG" >&2
            usage
            ;;
        :)
            # 处理需要参数但缺失的情况（例如 -f 后没有文件名）
            echo "错误: 选项 -$OPTARG 需要一个参数。" >&2
            usage
            ;;
    esac
done

# --- 移动位置参数 ---
# getopts 完成后，OPTIND 保存第一个非选项参数的索引。
# 我们使用 shift 丢弃所有已解析的选项，只留下位置参数（$1, $2 等）。
shift $((OPTIND - 1))

# 检查必需的位置参数（INPUT）是否存在
INPUT_DATA="$1"
if [ -z "$INPUT_DATA" ]; then
    echo "错误: 需要输入数据。"
    usage
fi

echo "---"
echo "正在处理输入: $INPUT_DATA"
echo "详细状态: $VERBOSE"

提示： 在 while getopts 循环之后立即使用 shift $((OPTIND - 1))，以干净地将选项与剩余的位置参数分开。

处理长选项，如 `--option`

纯Bash的内置 getopts 仅支持短选项。要处理现代的长选项（例如 --verbose、--output-file=data.log），你必须使用 while 和 case 结合 shift 命令实现自定义解析循环。

这种方法需要更明确的参数管理。

自定义长选项解析器

#!/bin/bash

# --- 默认值 ---
VERBOSE=0
OUTPUT_FILE=""

# 自定义显示用法的函数（为简洁起见省略）
# usage() { ... }

while [ "$#" -gt 0 ]; do
    case "$1" in
        --verbose)
            VERBOSE=1
            shift
            ;;
        --output-file)
            # 需要两次 shift：一次用于标志，一次用于值
            if [ -z "${2:-}" ]; then
                echo "错误: --output-file 需要一个值。"
                exit 1
            fi
            OUTPUT_FILE="$2"
            shift 2
            ;;
        --help)
            usage
            ;;
        -*)
            echo "错误: 未知选项 $1" >&2
            exit 1
            ;;
        *)
            # 找到第一个位置参数，停止解析选项
            break
            ;;
    esac
done

# 剩余参数现在可通过 $1, $2 等获取
# ... 脚本逻辑继续 ...

if [ "$OUTPUT_FILE" ]; then
    echo "数据重定向到 $OUTPUT_FILE"
fi

如果你的脚本在选项之后接受位置参数，请继续解析直到遇到 -- 或第一个非选项参数。一个常见的约定是让 -- 表示“现在停止解析选项”：

while [ "$#" -gt 0 ]; do
    case "$1" in
        --)
            shift
            break
            ;;
        --verbose)
            VERBOSE=1
            shift
            ;;
        *)
            break
            ;;
    esac
done

进阶：处理键值对长选项（`--key=value`）

如果你更喜欢使用等号传递参数的标准UNIX风格，你需要使用参数替换来拆分参数。

while [ "$#" -gt 0 ]; do
    case "$1" in
        --limit=*)
            LIMIT_VAL="${1#*=}" # 删除直到并包括 '=' 的所有内容
            echo "限制设置为: $LIMIT_VAL"
            shift
            ;;
        # ... 其他选项 ...
    esac
done

健壮脚本的最佳实践

A. 结合短选项和长选项

为了最大灵活性，经验丰富的脚本编写者通常将 getopts 的可靠性用于短选项，同时使用自定义的 while/case 循环处理长选项。长选项循环先运行，消耗长标志，然后剩余参数（包括短选项）由 getopts 处理。

然而，一种更简洁、常见的模式是在一个健壮的自定义循环中处理所有参数，该循环同时查找 -o 和 --option，并进行相应的 shift。

B. 错误处理与用法

始终提供一个清晰的 usage 函数，解释脚本的必需参数和选项。在以下情况下应调用此函数：

用户请求帮助（例如 -h 或 --help）。
缺少必需参数。
提供了无效或未知的选项。

确保脚本在出错时以非零状态退出（exit 1），并将错误消息输出到标准错误（>&2）。

C. 默认值

在脚本开头使用合理的默认值初始化所有配置变量。这样即使没有传递可选参数，你的脚本也是可预测的。

# 始终在解析前初始化变量
LOG_LEVEL="info"
FORCE=0

要点

对于简单的必需值使用位置参数，对于可移植的短选项使用 getopts，当需要长选项时使用自定义的 while/case 循环。在信任脚本用于自动化之前，测试缺失值、未知标志和带空格的参数。