启用 pipefail 后管道中任意命令失败即返回非零退出码，解决默认仅返回最后一个命令状态导致错误被忽略的问题；可通过 set -o pipefail 或 set -euo pipefail 启用，支持全局或子 shell 局部使用。

在 Linux 脚本中，默认情况下管道（|）只返回最后一个命令的退出状态，前面命令即使失败，整个管道也可能“看起来成功”，导致错误被忽略。启用 pipefail 选项后，只要管道中任意一个命令失败，整个管道就返回非零退出码，便于脚本准确判断和处理错误。

启用 pipefail 的方法

在脚本开头或需要的位置添加：

set -o pipefail

也可以写成：

set -o pipefail 或 set -o pipefail（两者等价）

若同时想让脚本在遇到未定义变量或命令失败时立即退出，可组合使用：

set -euo pipefail

对比默认行为与 pipefail 行为

假设有一个脚本片段：

cat nonexistent.txt | grep "hello"

Indie App Marketing Pipeline

模板驱动的多平台内容流水线，面向独立 iOS 开发者，自动生成并排期一周的社交媒体帖子（TikTok、YouTube Shorts、X/Twitter...）

下载

— 默认行为下：cat 失败（返回 1），但 grep 可能返回 0（比如输入为空时），整个管道返回 0，if 判断会误认为成功。

— 启用 pipefail 后：只要 cat 失败，整个管道就返回 1，if 能正确捕获错误。

在条件判断中安全使用管道

启用 pipefail 后，可直接用于 if 判断：

• set -o pipefail
• if cat file.txt | grep -q "pattern"; then echo "found"; else echo "not found or error"; fi

注意：grep -q 不输出内容，只影响退出码；若不加 -q，可能干扰后续逻辑，但不影响错误传播。

临时启用 pipefail（局部作用）

如果不想全局影响，可用子 shell 隔离：

(set -o pipefail; cmd1 | cmd2 | cmd3) || echo "pipeline failed"

这样仅该括号内生效，不影响脚本其余部分。

pipefail 是编写健壮 Shell 脚本的重要习惯，尤其在数据流处理、日志分析或 CI/CD 流程中，避免因前置命令静默失败而掩盖真实问题。