极客教程

Appearance

共 1,371 字预计阅读约 5 分钟

Shell 高手（00）：稳健脚本工程化 ​

更新时间：2026-08-31。本文是 languages/shell/intermediate/ 高手层第 0 篇。beginner 层教会"命令怎么写"，本篇解决脚本怎么写才不会半夜告警——严格模式、错误处理、调试、参数解析、进程替换，全是生产环境脚本的日常。前置：Shell 语法变量 与 控制流与函数。

一、本文要回答的问题 ​

  • 为什么脚本"在我机器上好好的，到服务器就静默失败"？
  • set -euo pipefail 这三个开关各防什么？
  • 一个能上生产线的脚本，参数解析、错误提示、退出码怎么组织？

二、严格模式：把"悄悄失败"变成"大声失败" ​

Bash 的默认行为对脚本极不友好：命令失败它不退出，而是继续往下跑。看这个经典事故现场：

bash
#!/bin/bash
cd /nonexistent/dir          # 失败，但脚本继续
rm -rf ./*                   # 在错误的目录里执行了！灾难
echo "done"

运行输出（危险！）：

$ bash bad.sh
rm: cannot remove './*': No such file or directory
done

cd 失败了，脚本却继续执行 rm。严格模式就是防这个的，三件套：

bash
#!/bin/bash
set -euo pipefail
开关作用防什么
set -e任何命令非零退出立刻终止脚本失败后继续执行
set -u使用未定义变量直接报错退出$UNSET 静默变成空串
set -o pipefail管道中任一命令失败，整条管道返回失败`cmd

实测：严格模式的威力 ​

bash
#!/bin/bash
set -euo pipefail
cd /nonexistent/dir
echo "我还能跑到这里吗？"   # 不会执行
$ bash strict.sh
strict.sh: line 3: cd: /nonexistent/dir: No such file or directory

脚本在 cd 处就停下了，echo 永远不会执行——错误在最早的地方爆炸，而不是在 20 行后以诡异的方式爆。注意 set -e 有个反直觉的坑：cmd || true 和 if cmd 里的失败不会触发退出（这是刻意的，否则没法写容错逻辑），这也是"知道规则才知道哪里可以绕"的典型。

三、trap：错误与退出的钩子 ​

trap 是 Bash 的"信号/退出钩子"：在脚本退出、收到信号、或特定事件时执行指定命令。生产脚本三件套用法：

bash
#!/bin/bash
set -euo pipefail

# 临时目录，退出时自动清理（最常用的模式）
TMPDIR=$(mktemp -d)
trap 'rm -rf "$TMPDIR"' EXIT

# 出错时打印行号（配合 -e 定位失败点）
trap 'echo "错误发生在第 $LINENO 行" >&2' ERR

# 收到 Ctrl+C 时优雅退出
trap 'echo "被中断，正在清理…"; exit 130' INT

实测：EXIT 钩子自动触发 ​

bash
#!/bin/bash
set -euo pipefail
trap 'echo "清理钩子执行"; rm -rf /tmp/demo_tmp' EXIT
mkdir -p /tmp/demo_tmp
echo "干正事…"
exit 0    # 或者正常结束
$ bash trap-demo.sh
干正事…
清理钩子执行

即使脚本中途 exit 或出错退出，EXIT 钩子也会触发——临时文件、PID 文件这类资源不会泄漏。ERR 钩子配 set -e 是"出错秒定位"的组合拳：$LINENO 直接告诉你哪一行翻车。

四、调试三板斧 ​

手段作用何时用
bash -n script.sh只检查语法，不执行写完后先查语法
bash -x script.sh逐行打印执行的命令（展开后）定位逻辑错误、变量没展开
bash -v script.sh打印原始输入行看脚本走到哪一行

-x 是最常用的，看它展开变量后的真相：

bash
#!/bin/bash
name="world"
for i in 1 2 3; do
    echo "hello $name $i"
done
$ bash -x debug.sh
+ name=world
+ for i in 1 2 3
+ echo 'hello world 1'
hello world 1
+ echo 'hello world 2'
hello world 2
+ echo 'hello world 3'
hello world 3

+ 开头的行是展开后的命令——$name、$i 都变成了实际值。变量引用写错、命令被意外分词，-x 一眼就照出原型。脚本里还可以局部开 set -x / set +x 只调试某一段，避免全量刷屏。

五、参数解析：getopts 还是手写 ​

脚本要接参数时，手写 $1 $2 定位脆弱且没帮助信息。getopts 是 Bash 内置的参数解析器，支持 -a、-v、-f file 这类常见风格：

bash
#!/bin/bash
set -euo pipefail

usage() {
    echo "用法: $0 [-v] [-f 文件] [输入]"
    exit 1
}

verbose=0
file=""
while getopts "vf:h" opt; do
    case "$opt" in
        v) verbose=1 ;;
        f) file="$OPTARG" ;;
        h) usage ;;
        *) usage ;;
    esac
done
shift $((OPTIND - 1))     # 跳过已处理的选项，剩余的是位置参数

echo "verbose=$verbose, file=${file:-无}, 位置参数=${*:-无}"

实测：三种调用 ​

$ bash args.sh -v -f app.conf input.txt
verbose=1, file=app.conf, 位置参数=input.txt

$ bash args.sh input.txt
verbose=0, file=无, 位置参数=input.txt

$ bash args.sh -x
args.sh: illegal option -- x
用法: ./args.sh [-v] [-f 文件] [输入]

注意 getopts 的选项字符串 "vf:h"：字母后带冒号（f:）表示"该选项需要参数"，$OPTARG 取到参数值。非法选项自动报错并走 * 分支。这比手写 case $1 健壮得多——用户传错参数时得到的是帮助信息，而不是诡异的运行结果。

六、进程替换与子 shell：管道之外的高级组合 ​

进程替换：把命令输出当文件用 ​

进程替换 <(...) 和 >(...) 让命令看起来像个文件，解决"某命令要求传文件、但数据在管道里"的尴尬：

bash
# 对比两个命令的输出（diff 要文件参数）
diff <(grep "ERROR" app.log | sort) <(grep "WARN" app.log | sort)

# 把结果同时喂给两个"下游"（管道只能喂一个）
command_with_big_output > >(grep ERROR > errors.txt) > >(grep WARN > warns.txt)

第一个例子里，<(...) 把 grep+sort 的输出伪装成临时文件路径交给 diff——管道做不到这种"多输入/多输出"的活。它是 /dev/fd 机制的糖衣，理解原理见 Bash 内部机制。

子 shell：括号里的世界 ​

( ... ) 创建一个子 shell（fork 出的子进程），里面的变量修改、cd 都不影响父 shell：

bash
cd /tmp            # 父 shell 的 cd
(cd /var && pwd)   # 子 shell 的 cd，只影响子 shell
pwd                # 还是 /tmp
$ pwd
/workspace
$ (cd /var && pwd)
/var
$ pwd
/workspace

子 shell 是"临时改环境又不想污染当前"的干净手段。注意它和 { ...; }（当前 shell 里组合）的区别——需要隔离副作用用 ( )，只是分组用 { }。

七、实战组合：一个像样的部署脚本骨架 ​

把上面所有技巧拼成一个最小但完整的脚本：

bash
#!/bin/bash
set -euo pipefail
trap 'rm -rf "$TMP_DIR"' EXIT

TMP_DIR=$(mktemp -d)
log() { echo "[$(date '+%F %T')] $*"; }
die() { log "FATAL: $*" >&2; exit 1; }

[ -n "${DEPLOY_TARGET:-}" ] || die "缺少环境变量 DEPLOY_TARGET"
[ -f "build.tar.gz" ] || die "找不到 build.tar.gz"

log "解压到临时目录…"
tar xzf build.tar.gz -C "$TMP_DIR"
log "同步到 $DEPLOY_TARGET…"
rsync -az --delete "$TMP_DIR/" "$DEPLOY_TARGET/" || die "同步失败"
log "部署完成 ✅"
$ DEPLOY_TARGET=/tmp/app ./deploy.sh
[2026-08-31 10:00:01] 解压到临时目录…
[2026-08-31 10:00:02] 同步到 /tmp/app…
[2026-08-31 10:00:03] 部署完成 ✅

这个骨架的每一行都有讲究：set -euo pipefail 兜底、trap EXIT 保证临时目录必清、die() 统一错误出口、${VAR:-} 语法做"缺省默认值"式检查。脚本工程化的全部要点浓缩在这 15 行里。

八、与本站其他内容的衔接 ​

一句话：Shell 高手层的核心是把脚本从"能跑"变成"能扛"——set -euo pipefail 让错误尽早爆炸、trap 管好清理钩子、bash -x 照出逻辑死角、getopts 接好参数，配上进程替换和子 shell，脚本就具备了上生产线的底子。