写出更可靠的 Shell 脚本:set -euo pipefail 严格模式实战

举报
yd_255038127 发表于 2026/11/15 17:36:37 2026/11/15
【摘要】 Shell 脚本是运维和开发中最常用的自动化工具,但默认的 Bash 行为非常“宽容”:命令失败了继续执行、变量名拼错了被当成空字符串、管道中间的命令失败了也被忽略。很多线上事故的根因不是逻辑写错,而是脚本在错误发生后还在继续执行。本文介绍 Bash 的严格模式 set -euo pipefail,并给出可直接套用的脚本模板。 一、一个真实的翻车例子假设要写一个清理临时文件的脚本:#!/bi...

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 做静态检查,大部分低级失误在上线前就能被发现。脚本的可靠性不是靠事后救火,而是靠这种让错误尽早暴露的习惯。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。