Bash脚本：解读 `set -euo pipefail`

解读 set -euo pipefail 这行 bash 脚本代码。

这行命令是 Bash Shell 内建命令 set 的一种用法，通过组合不同的选项来修改 Shell 脚本的执行行为，目的是让脚本更加健壮、更易于调试，并能更早地发现潜在错误。它通常放在脚本的开头。

我们来分别看一下每个选项的含义：

1. set -e (或者 set -o errexit)

   • 作用：当脚本中的任何简单命令（非 while, until, if 控制结构中的测试，也不是 && 或 || 列表的一部分）执行后返回非零退出状态码（表示执行出错）时，脚本会立即退出。
   • 目的：防止脚本在某个命令失败后继续执行后续可能依赖于该命令成功执行的命令，从而避免产生意想不到的后果或数据损坏。"快速失败"原则。
   • 注意：这个选项的行为有一些细微之处，比如在管道命令 (|) 中，默认只关心最后一个命令的退出状态。这也是为什么通常会配合 pipefail 使用。

2. set -u (或者 set -o nounset)

   • 作用：当脚本尝试使用一个未定义（unset）的变量时（除了特殊变量 @ 和 *），Bash 会将其视为错误，并导致脚本立即退出。
   • 目的：防止因变量名拼写错误或逻辑错误（期望变量已赋值但实际未赋值）而导致脚本使用了空值或非预期的默认值。可以帮助捕获很多常见的错误。

3. set -o pipefail

   • 作用：修改管道命令 (|) 的退出状态码行为。默认情况下，一个管道命令的退出状态码是管道中最后一个命令的退出状态码。设置 pipefail 后，整个管道命令的退出状态码将是管道中最后一个返回非零退出状态码的命令的状态码；如果管道中所有命令都成功执行（返回0），则整个管道的状态码为0。
   • 目的：确保管道中任何一个环节的失败都会被捕获。这与 set -e 结合使用时尤其重要。如果没有 pipefail，即使管道前面的命令失败了，只要最后一个命令成功，set -e 也不会触发退出。有了 pipefail，只要管道中任何一个命令失败，整个管道就会返回非零状态码，从而触发 set -e 使脚本退出。

总结:

set -euo pipefail 这行代码组合了三个强大的错误检查选项：

• -e: 命令失败立即退出。
• -u: 使用未定义变量立即退出。
• -o pipefail: 管道中任何命令失败，整个管道视为失败。

将它们放在一起，可以创建一个更严格、更安全的脚本执行环境。脚本会在遇到常见错误（命令执行失败、使用未定义变量、管道中途失败）时立即停止，而不是默默地继续执行，这使得调试更加容易，并提高了脚本的可靠性。因此，set -euo pipefail 被广泛认为是编写 Bash 脚本的最佳实践之一，有时被称为 Bash 的“非官方严格模式”(unofficial strict mode)。