Linux Shell 脚本:set -euo pipefail 与常见坑

举报
yd_235578648 发表于 2026/11/18 09:21:45 2026/11/18
【摘要】 Linux Shell 脚本:set -euo pipefail 与常见坑Shell 脚本最容易出的问题,不是语法写错,而是出错了还继续往下跑:上一条命令失败了,下一条照样执行,最后不知道哪一步坏的。解决方法是开头先加三行,再避开几个常见坑。 开头先加三行#!/bin/bashset -euo pipefail三个选项各管一件事:-e:任何一条命令失败,脚本立刻停住,不继续往下跑;-u:用...

Linux Shell 脚本:set -euo pipefail 与常见坑

Shell 脚本最容易出的问题,不是语法写错,而是出错了还继续往下跑:上一条命令失败了,下一条照样执行,最后不知道哪一步坏的。解决方法是开头先加三行,再避开几个常见坑。

开头先加三行

#!/bin/bash
set -euo pipefail

三个选项各管一件事:

  • -e:任何一条命令失败,脚本立刻停住,不继续往下跑;
  • -u:用了没定义过的变量,立刻报错停住,不拿空值继续跑;
  • -o pipefail:管道里任何一段失败,整条管道就算失败,不只看最后一段。

再加一行,出错时报行号:

trap 'echo "failed at line $LINENO"' ERR

脚本跑到一半停住,至少知道停在哪一行,而不是只看到一个失败的结果。

坑一:变量不加引号

# 错:文件名带空格会被拆成两个参数
rm $file

# 对:变量一律加引号
rm "$file"

"$var" 这条习惯要刻进手里。目录、文件名、用户输入都可能带空格,不加引号,拆散之后删错东西都不知道。

坑二:cd 失败了还继续

# 错:cd 失败了,下一条 rm 还是在原目录执行
cd /data/app
rm -rf ./tmp/*

# 对:cd 失败就停
cd /data/app || exit 1
rm -rf ./tmp/*

有 set -e 时 cd 失败本身会停住,但写上 || exit 1 更明确。删文件之前,先确认自己在哪个目录:pwd 看一眼再动手。

坑三:rm -rf 后面跟了空变量

# 危险:$dir 为空时,这条变成 rm -rf /*
rm -rf "$dir"/*

# 稳妥:先判断非空
[ -n "$dir" ] && [ -d "$dir" ] && rm -rf "$dir"/*

删之前判断变量非空、目录存在,这两步不能省。rm -rf 没有后悔药,脚本里尤其要收着写。

坑四:管道只看最后一段

# 没有 pipefail 时,grep 失败了,整条管道的退出码还是 echo 的 0
grep "error" app.log | wc -l

# 加了 set -o pipefail,grep 没找到内容也算失败,按需处理
grep "error" app.log | wc -l || true

grep 没找到内容返回 1,这本身不是错误。知道它会返回 1,就按需加 || true,而不是关掉 pipefail。

坑五:用 ls 的结果做循环

# 错:文件名带空格、换行都会被拆散
for f in $(ls *.log); do echo "$f"; done

# 对:直接用 glob
for f in *.log; do echo "$f"; done

ls 的输出是给人看的,不是给脚本解析的。循环文件直接用 glob,简单也稳。

一张检查清单

写完脚本先过一遍:

  1. 开头有没有 set -euo pipefail;
  2. 所有变量是不是都加了引号;
  3. cd、rm 这类危险操作前面有没有判断;
  4. 管道里失败的那一段是不是按预期处理了;
  5. 先在测试目录跑一遍,再上正式目录。

说明:本文所列做法均为 Shell 脚本常见写法,不同 Bash 版本细节可能有差异,以实际环境为准。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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