本文说明 Shell 的流程控制与函数。变量与展开规则见 变量与参数展开,脚本执行与调试见 脚本执行,严格模式与错误处理见 错误处理与脚本工程,文本处理与条件筛选取数见 文本处理工具,循环与判断在运维脚本中的实际用法见 定时任务与定时器 与 故障案例库。

一、起源

1.1 三类混淆来源

混淆 表现 根因
真假来自退出码 if 后面可以跟任意命令 判断依据不是布尔值而是命令的退出码
测试语法多样 单方括号、双方括号、双圆括号写法不同 分别属于命令、关键字与算术求值
作用范围不直观 管道后面的循环修改的变量"没生效" 管道会创建子 shell,变量修改发生在子进程中

1.2 判断的实质

Shell 中"条件成立"等价于"命令退出码为 0"。因此 if 后面既可以跟测试命令,也可以跟任意命令:

if grep -q 'ERROR' app.log; then
    echo "存在错误"
fi

# 与上面的写法等价,利用退出码直接连接
grep -q 'ERROR' app.log && echo "存在错误"
grep -q 'ERROR' app.log || echo "不存在错误"

理解这一点后,"为什么 if [ ... ] 里的方括号两侧必须有空格"也得到解释:方括号是一个命令名,不是一个语法符号。

1.3 取舍

选择 获得 付出
使用双方括号与算术求值 语义更清晰、支持模式与正则、无分词陷阱 仅适用于 bash,sh 下不可用
只使用单方括号 可移植性最好 需要严格加引号,逻辑运算符写法繁琐

有 bash 可用时优先使用双方括号与双圆括号;需要兼容最小系统(如部分容器的精简环境)时使用单方括号并严格遵守引用纪律。

二、原理

2.1 条件判断的三种写法

写法 类型 特点
[ 表达式 ] 命令 需要空格分隔、需要对变量加引号、-a 与 -o 表达与或
[[ 表达式 ]] 关键字 不做分词与通配、支持 == 的模式匹配与 =~ 正则、支持 && 与 \|\|
(( 表达式 )) 算术求值 用于整数比较与运算,退出码即判断结果
# 三种写法的对照
[ "$name" = "app" ] && echo "命令写法"
[[ $name == app ]] && echo "关键字写法"
(( count > 10 )) && echo "算术写法"

# 双方括号支持模式与正则,单方括号不支持
[[ $file == *.log ]] && echo "日志文件"
[[ $version =~ ^v[0-9]+\.[0-9]+$ ]] && echo "版本格式正确"

2.2 测试速查

类别 单方括号 双方括号 说明
字符串为空 [ -z "$s" ] [[ -z $s ]] 双方括号内可省引号
字符串非空 [ -n "$s" ] [[ -n $s ]]
字符串相等 [ "$a" = "$b" ] [[ $a == $b ]] 单方括号的 = 不是模式匹配
字符串字典序 不支持 [[ $a < $b ]] 需要转义或改用双方括号
整数比较 [ "$a" -gt "$b" ] (( a > b )) 切勿用 > 做整数比较
文件存在 [ -e "$p" ] [[ -e $p ]]
是普通文件 [ -f "$p" ] [[ -f $p ]]
是目录 [ -d "$p" ] [[ -d $p ]]
是符号链接 [ -L "$p" ] [[ -L $p ]]
可读可写可执行 [ -r/-w/-x "$p" ] 同左
非空文件 [ -s "$p" ] 同左 用于判断日志是否为空
修改时间比较 不支持 [[ $a -nt $b ]] 旧于用 -ot

最常见的两个错误:用 > 或 < 做整数比较(会被解析为重定向),以及对可能为空的变量不加引号(参数不足导致语法错误)。

2.3 退出码

退出码 含义
0 成功
1 通用失败
2 用法错误(含部分内建命令的参数错误)
126 找到了但不可执行
127 命令未找到
128 加信号号 被信号终止,如 130 表示被中断信号终止

约定:脚本自身也应按含义返回不同退出码,便于调用方判断失败类型;具体规范见 错误处理与脚本工程。

2.4 分支结构

# if 与 elif
if [[ -f "$pid_file" ]] && kill -0 "$(cat "$pid_file")" 2>/dev/null; then
    echo "已在运行"
elif [[ -e "$pid_file" ]]; then
    echo "存在残留文件,进程已退出"
else
    echo "未运行"
fi

# case:按模式匹配,支持通配
case "$action" in
    start|restart)   do_start ;;
    stop)            do_stop ;;
    status)          do_status ;;
    reload)          do_reload ;;
    -h|--help|help)  usage ;;
    *)               printf '未知动作:%s\n' "$action" >&2; exit 2 ;;
esac

三种分支结束方式:

结束符 行为
;; 结束本次匹配,不再测试后续模式
;& 继续执行下一个分支的语句体(不再测试条件)
;;& 继续测试后续模式,可能命中多个分支

默认使用 ;;,另两种仅在明确需要连续匹配时使用。

2.5 循环结构

# for:遍历列表
for env in dev test prod; do
    printf 'deploy to %s\n' "$env"
done

# for:遍历数组(必须加引号)
for svc in "${services[@]}"; do
    printf 'service=%s\n' "$svc"
done

# for:遍历命令输出(按行读取,避免分词)
while IFS= read -r line; do
    printf 'line=%s\n' "$line"
done < <(grep 'ERROR' app.log)

# for:C 风格
for ((i = 0; i < 3; i++)); do
    printf 'retry %d\n' "$i"
done

# while:条件循环
while [[ ! -f "$ready_file" ]]; do
    sleep 1
done

# until:与 while 相反,条件不成立时循环
until [[ -f "$ready_file" ]]; do
    sleep 1
done

遍历命令输出时不要写成 for f in $(cmd):命令替换会把输出按分隔符拆成单词,文件名含空格时会被拆成多个。正确写法是使用逐行读取加进程替换。

2.6 循环控制

# break 与 continue 可带层数,用于控制外层循环
for site in "${sites[@]}"; do
    for host in "${hosts[@]}"; do
        if ! ping -c 1 -W 1 "$host" >/dev/null 2>&1; then
            continue 2        # 跳过该站点的其余主机
        fi
    done
done

不带层数时只作用于最内层循环,这是"改了却没生效"的常见原因。

2.7 命令组与子 shell

写法 作用范围 典型用途
{ 命令; } 当前 Shell 需要修改当前变量或环境的组合操作
( 命令 ) 子 Shell 需要隔离影响的临时操作,如切换目录
# 花括号:在当前 Shell 中执行,变量修改保留(注意必须有分号与空格)
{ cd /tmp && ls > out.txt; }

# 圆括号:在子 Shell 中执行,目录切换与变量修改不影响父 Shell
(cd /tmp && ls > out.txt)
pwd     # 仍在原目录

管道中丢失变量是子 shell 最典型的后果:在 bash 中,管道的每一段都在子进程中执行,因此管道右侧的循环对变量的修改在管道结束后不可见。

# 错误:计数在子 Shell 中完成,父 Shell 中仍为 0
count=0
grep 'ERROR' app.log | while read -r line; do
    (( count++ ))
done
echo "$count"        # 0

# 做法一:用进程替换把输入交给 while,循环在当前 Shell 执行
count=0
while IFS= read -r line; do
    (( count++ ))
done < <(grep 'ERROR' app.log)
echo "$count"        # 正确

# 做法二:用命令替换直接取回结果,避免在循环中累积
count=$(grep -c 'ERROR' app.log)

# 做法三:需要在循环中修改多个变量时,把结果一次性输出并在外层读取
read -r total failed < <(
    awk '/ERROR/ { total++; if ($0 ~ /failed/) failed++ } END { print total+0, failed+0 }' app.log
)

选择依据:只统计数量时用做法二最简单;需要在循环中累积多种状态时用做法一;逻辑复杂时把统计交给文本处理工具(做法三)。

2.8 函数

# 定义与调用:定义时不写参数列表,调用时不写括号
log_info() {
    printf '[%s] [INFO] %s\n' "$(date '+%F %T')" "$*"
}

fail() {
    printf '[%s] [ERROR] %s\n' "$(date '+%F %T')" "$*" >&2
    exit 1
}

# 函数的三条接口约定
# 1. 参数通过位置参数传入,使用 "$@" 透传
# 2. 返回值只能是退出码(0 至 255),输出通过标准输出返回
# 3. 内部变量用 local 声明
retry() {
    local max="$1" delay="$2"
    shift 2
    local i
    for ((i = 1; i <= max; i++)); do
        if "$@"; then
            return 0
        fi
        sleep "$delay"
    done
    return 1
}

# 使用:把命令与参数一起传入
retry 3 2 curl -sf -o /dev/null https://internal/health \
    || fail "健康检查连续失败"

# 取回输出:命令替换 + 标准输出
get_ip() {
    local iface="$1"
    ip -4 -o addr show dev "$iface" | awk '{print $4}' | cut -d/ -f1
}
addr=$(get_ip eth0)
# 函数库:把通用函数放在单独文件并被引用
# lib/common.sh
log_info() { printf '[INFO] %s\n' "$*"; }
require_cmd() { command -v "$1" >/dev/null 2>&1 || { echo "缺少命令:$1" >&2; exit 3; }; }

# 业务脚本中引用(source 在当前 Shell 执行,可共享变量与函数)
source "$(dirname -- "$0")/lib/common.sh"
require_cmd curl
log_info "开始执行"

要点:引用路径应基于脚本所在目录推导,而不是依赖调用时的当前目录,否则从其他目录调用会找不到函数库。

2.9 模式匹配

模式 含义 示例
* 任意长度字符串 *.log
? 单个字符 app?.log
[abc]、[a-z] 字符集合或范围 [0-9][0-9]
[[:digit:]] 等 字符类 [[:space:]]
!(...)、@(...)、+(...)、?(...)、*(...) 扩展模式需要开启扩展选项 @(start\|stop)

扩展模式在双方括号与 case 中可用,但需要先开启扩展选项;默认不支持扩展模式时 ! 等写法会被当作字面字符。

三、实现

3.1 子命令解析模板

#!/usr/bin/env bash
set -euo pipefail

usage() {
    cat <<'EOF'
用法:deploy.sh <动作> [选项]
动作:
  deploy    发布指定环境
  rollback  回滚到上一版本
  status    查看当前状态
选项:
  -e, --env <环境>   目标环境,默认 dev
  -h, --help         显示本帮助
EOF
}

main() {
    local action="${1:-}"
    [[ -n "$action" ]] || { usage; exit 2; }
    shift || true

    local env="dev"
    while [[ $# -gt 0 ]]; do
        case "$1" in
            -e|--env) env="${2:?缺少环境参数}"; shift 2 ;;
            -h|--help) usage; exit 0 ;;
            *) printf '未知选项:%s\n' "$1" >&2; usage; exit 2 ;;
        esac
    done

    case "$action" in
        deploy)   do_deploy "$env" ;;
        rollback) do_rollback "$env" ;;
        status)   do_status "$env" ;;
        *)        printf '未知动作:%s\n' "$action" >&2; usage; exit 2 ;;
    esac
}

main "$@"

要点:选项解析放在动作之后,shift 2 一次性跳过选项与取值;"$@" 在 main 中完整透传,保证含空格的参数不被拆开。

3.2 循环写法正误对照

# 遍历命令输出
bad()  { for f in $(find /data -name '*.log'); do echo "$f"; done; }
good() { while IFS= read -r f; do echo "$f"; done < <(find /data -name '*.log' -print0 | xargs -0 -n1 echo); }
better(){ find /data -name '*.log' -print0 | while IFS= read -r -d '' f; do echo "$f"; done; }

# 遍历文件通配
bad()  { for f in $(ls *.log); do echo "$f"; done; }
good() { for f in *.log; do [[ -e $f ]] || continue; echo "$f"; done; }

# 逐行读取配置文件
bad()  { while read -r k v; do echo "$k=$v"; done < config.ini; }        # 空行与多余空白处理不一致
good() { while IFS='=' read -r k v; do [[ -z $k || $k == \#* ]] && continue; printf '%s=%s\n' "$k" "$v"; done < config.ini; }

要点:文件名遍历必须使用通配或空字符分隔,逐行读取必须显式设置分隔符并跳过空行与注释行。

3.3 判断写法速查

# 文件与目录
[[ -f $path && -r $path ]] && log_info "文件可读"
[[ -d $dir ]] || mkdir -p -- "$dir"

# 命令是否存在(优先于 which)
command -v curl >/dev/null 2>&1 || { echo "缺少 curl" >&2; exit 3; }

# 变量是否已设置
[[ -v PORT ]] && echo "PORT 已设置"

# 字符串匹配与正则
[[ $file == *.tar.gz ]] && echo "压缩包"
[[ $email =~ ^[^@]+@[^@]+\.[^@]+$ ]] && echo "格式合法"

# 整数范围校验
if (( keep_days < 0 || keep_days > 365 )); then
    echo "保留天数超出范围" >&2; exit 2
fi

# 端口是否被监听(结合文本处理)
ss -lnt | awk '{print $4}' | grep -q ":${port}$" && echo "端口已监听"

3.4 常见问题对照

现象 常见原因 处置
方括号判断报语法错误 方括号两侧缺少空格或变量为空未加引号 补空格并按需改用双方括号
整数比较结果错误 使用了重定向符号做比较 改用算术比较或数值比较符
字符串比较被当作模式 单方括号内使用了 == 且右侧含通配字符 改用双方括号并明确是否要用模式
循环里的计数在循环外为 0 管道创建子 Shell 改用进程替换或命令替换
循环次数与预期不符 遍历命令输出时发生分词 改为逐行读取
文件名为空时循环执行一次 通配未匹配时保留原样 循环内判断文件是否存在
跳出多层循环没生效 break 未指定层数 使用 break n
函数返回值取到的是输出 误以为 return 可返回字符串 用标准输出返回数据,用退出码表示成败
函数内变量影响外部 未使用 local 局部变量显式声明
引用的函数库找不到 路径基于当前目录而非脚本目录 基于脚本所在目录推导路径
分支只命中了第一个 误用了 ;& 或 ;;& 默认使用 ;;
扩展模式匹配不生效 未开启扩展模式选项 开启后使用,或改用 case 的多模式写法

四、总结

  1. Shell 以命令退出码作为真假,因此判断可以作用于任意命令,方括号本质上是一个命令而不是语法符号。
  2. 条件有三种写法:单方括号可移植但需严格引用,双方括号支持模式与正则且无分词陷阱,双圆括号用于整数比较与运算。
  3. 测试分为文件、字符串与数值三类,最常见错误是用重定向符号做整数比较,以及对可能为空的变量不加引号。
  4. 脚本应返回有含义的退出码,便于调用方区分失败类型,退出码约定与错误处理一并设计。
  5. case 按模式匹配,默认用 ;; 结束分支,另两种结束符仅在需要连续匹配时使用。
  6. for 有三种形式,遍历命令输出时不能直接展开命令替换,必须逐行读取;遍历文件名使用通配而不是解析列表输出。
  7. 循环控制不带层数时只作用于最内层,需要跳出外层时必须显式指定层数。
  8. 花括号组在当前 Shell 执行、圆括号组在子 Shell 执行,管道右侧的命令在子 Shell 中运行,这是循环内变量修改"丢失"的根因。
  9. 函数通过位置参数接收输入、通过标准输出返回数据、通过退出码表示成败,内部变量必须声明为局部。
  10. 函数库应基于脚本所在目录引用,脚本入口统一用 main "$@" 组织,保证参数透传与子命令解析的一致性。