写出更可靠的 Shell 脚本:set -euo pipefail 严格模式实战
Shell 脚本是运维和开发中最常用的自动化工具,但默认的 Bash 行为非常“宽容”:命令失败了继续执行、变量名拼错了被当成空字符串、管道中间的命令失败了也被忽略。很多线上事故的根因不是逻辑写错,而是脚本在错误发生后还在继续执行。本文介绍 Bash 的严格模式 set -euo pipefail,并给出可直接套用的脚本模板。
一、一个真实的翻车例子
假设要写一个清理临时文件的脚本:
#!/bin/bash
cd /data/tmp
rm -f *.log
如果 /data/tmp 目录不存在,cd 会失败并返回非零退出码,但脚本不会停下来——它会在当前目录继续执行 rm -f *.log,删掉的可能是完全不相干的文件。这就是默认 Bash 最危险的地方:错误发生了,脚本却若无其事地继续跑。
二、set -e:出错即停
set -e(等价于 set -o errexit)让脚本在任何命令返回非零退出码时立即退出:
#!/bin/bash
set -e
cd /data/tmp # 目录不存在时脚本立即退出,不会执行后面的 rm
rm -f *.log
需要注意,set -e 有几个例外:它不会因为 if 条件、while 条件、&& 或 || 列表中的命令失败而退出,这些位置的失败本身就是逻辑的一部分。
三、set -u:未定义变量即报错
set -u(等价于 set -o nounset)让脚本在使用未定义变量时立即报错退出:
#!/bin/bash
set -u
echo "备份目录是:$BACKUP_DIR"
如果 BACKUP_DIR 没有被赋值,脚本会报错 BACKUP_DIR: unbound variable 并退出,而不是悄悄把它当成空字符串。变量名拼写错误是 Shell 脚本最常见的 bug 之一,set -u 能在第一时间把它揪出来。需要允许变量为空时,可以用默认值语法 ${BACKUP_DIR:-/tmp}。
四、set -o pipefail:管道失败不再被掩盖
默认情况下,管道的退出码只取决于最后一个命令:
grep "ERROR" /var/log/app.log | wc -l
echo $? # 即使 grep 因为文件不存在而失败,这里也只看到 wc 的退出码 0
加上 set -o pipefail 后,管道中任何一个命令失败,整个管道就返回非零退出码,配合 set -e 就能在第一时间停下来。
五、组合使用与脚本模板
把三者写在脚本开头,就是常说的严格模式:
#!/bin/bash
set -euo pipefail
IFS=$'\n\t'
LOG_DIR="${1:-/var/log}"
echo "开始检查 ${LOG_DIR} 下的日志..."
count=$(grep -r "ERROR" "${LOG_DIR}" | wc -l)
echo "共发现 ${count} 条错误日志"
IFS=$'\n\t' 是可选的补充:它把字段分隔符收窄为换行与制表符,避免文件名或日志内容中的空格被错误拆分。
严格模式也有需要留意的点:
- 有意允许失败的命令,要显式写清楚,例如
grep "x" file || true,或者用if包裹; - 需要临时关闭严格模式时,用
set +e,用完再用set -e打开; - 调试时可以加上
set -x,把每条实际执行的命令打印出来,定位问题更快。
六、结语
set -euo pipefail 只有一行,却能把 Shell 脚本从“出错了还继续跑”变成“出错立即停下并报错”。把它作为每个新脚本的固定开头,再配合 shellcheck 做静态检查,大部分低级失误在上线前就能被发现。脚本的可靠性不是靠事后救火,而是靠这种让错误尽早暴露的习惯。
- 点赞
- 收藏
- 关注作者
评论(0)