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