详解Bash set 命令：set -e、set -x 和 set -u 完全指南

默认情况下，Bash 脚本即使某条命令执行失败，也会继续运行。变量名拼写错误会被展开为空字符串，失败的 cd 命令被忽略，脚本若无其事地继续执行，往往在最终停下来之前已经造成了实质性损害。set 内建命令改变了这一切。通过几个标志，你可以让 Bash 在遇到第一个错误时停止执行，将未定义的变量视为错误，并逐条打印执行的每条命令。

本指南详细讲解 set 命令以及你最常用的三个选项：set -e、set -u和set -x，此外还包括 pipefail 以及如何将它们组合成严格模式。

一、set 命令的作用

set 是一个 Shell 内建命令，用于开启或关闭 Shell 选项，以及设置位置参数。对于选项，它采用以下形式：

set [选项]

每个选项都有短格式和长格式。开头的减号（-） 表示开启选项，加号（+） 表示关闭选项——这与大多数人的直觉相反：

通常将这些命令放在脚本顶部附近，使其对后续所有代码生效；或者放在特定代码块周围，使其仅对该部分脚本生效。

二、set -e：出错时立即退出

set -e（也写作 set -o errexit）指示 Bash 在任何命令返回非零状态码时立即退出。它可以防止脚本在失败后继续执行。

# 示例：进入目录并写日志

cleanup.sh

#!/bin/bash
set -e

cd /var/cache/myapp
printf 'Cleaning application cache\n'

• 没有set -e：如果 cd 失败（目录不存在），脚本会继续执行，在当前所在目录中打印日志信息
• 有set -e：cd 失败后脚本立即停止，日志信息和后续缓存命令都不会执行

重要例外情况set -e在以下情况下不会触发退出（这常常让人踩坑）：

grep "pattern" file.txt || true

3.set -u：将未定义变量视为错误

set -u（或set -o nounset）使得 Bash 在引用未定义的变量时退出。这能捕获脚本中最常见的错误之一：变量名拼写错误导致静默展开为空字符串。

示例：部署脚本 deploy.sh

#!/bin/bash
set -u

target_dir="/srv/www"
printf 'Target cache directory: %s\n' "${tagret_dir}/cache"

变量名错误地写成了 tagret_dir：

• 没有set -u：${tagret_dir}展开为空字符串，输出/cache而非/srv/www/cache；
• 有set -u：Bash 立即报错并退出：

  deploy.sh: line 5: tagret_dir: unbound variable
  

处理可选变量当某个变量确实可选时，使用${VAR:-default}提供默认值，确保引用始终已定义：

echo "Deploying to ${ENVIRONMENT:-staging}"

四、set -x：逐条跟踪命令

set -x（或set -o xtrace）在执行每条命令之前将其打印到标准错误输出，并展开所有变量值。这是在不添加大量 echo 语句的情况下，精确查看脚本执行过程的最快方式。

示例：问候脚本 greet.sh

#!/bin/bash
set -x

name="Haopython"
echo "Hello, $name"

运行脚本时，每条命令前会带有 + 前缀，与正常输出一同显示：
<pre+ name=Haopython + echo ‘Hello, Haopython’ Hello, Haopython

跟踪输出显示变量已被展开，因此看到的是 Bash 实际使用的真实值。

自定义 PS4 变量

前缀来自 PS4 变量。将其设置为包含脚本名称和行号，在较长的脚本中非常有用：

PS4='+ ${BASH_SOURCE}:${LINENO}: '

只调试特定代码段由于跟踪输出信息量大，常见做法是仅在需要调试的代码段周围启用跟踪：

set -x
deploy_application
sync_assets
set +x

只有set -x和set +x之间的两条命令会被跟踪输出。

五、set -o pipefail：捕获管道中的失败

默认情况下，管道命令返回的是最后一条命令的退出状态，因此管道前期的失败会被隐藏。# 示例：搜索日志文件

grep "ERROR" missing.log | wc -l

在该管道中，即使 grep 因为文件不存在而失败，wc 仍然成功，整个管道退出状态为 0（来自 wc）。set -o pipefail改变了这一行为：管道返回最右侧失败命令的状态，如果所有命令都成功则返回 0。与set -e结合使用时，管道前期的失败也能真正停止脚本的执行。

六、组合成严格模式

这些选项组合在一起效果最好。顶部常见的组合是：script.sh

#!/bin/bash
set -euo pipefail

这一行同时启用了：

• 出错时退出（-e）；
• 未定义变量检查（-u）；
• 管道失败检测（pipefail）。

调试时再加上 -x：set -euxo pipefail，调试完成后移除 -x。

这种模式是所谓的 “Bash 严格模式” 的基础。

七、针对代码块启用和禁用选项

不必将选项应用于整个脚本。可以在某个代码块中开启，之后关闭。这在跟踪调试时很常见：

set -x
deploy_application
sync_assets
set +x

只有set -x和set +x之间的两条命令会被跟踪。同样的模式也适用于set -e，当需要手动处理某个部分的错误时非常有用。

八、查看当前选项

不带任何标志运行set -o会列出所有选项及其开关状态。完整列表有二十多个条目，本文讨论的四个选项如下：

set -o

输出示例：

errexit         off
nounset         off
pipefail        off
xtrace          off

这是快速确认交互式 Shell 或已 source 的脚本启用了哪些选项的方法。

九、设置位置参数

set 命令还有与选项无关的第二项功能：当在 — 之后给出参数时，它会替换位置参数$1、$2 等。当想重置脚本或函数读取的参数时，这非常有用：

set -- one two three
echo "$2"

输出：

two

— 标记选项结束，确保以减号开头的参数不会被误认为是选项标志。

十、快速参考

十一、常见问题解答（FAQ）

Q1：set -e 和 set -o errexit 有什么区别？

没有区别。set -e是短格式，set -o errexit是更长、更具可读性的长格式。选择你喜欢的即可；长格式在共享脚本中更常见，因为它们具有自文档性。

Q2：为什么我的脚本在 set -e 开启后，命令失败仍然继续执行？

失败的命令可能位于以下位置：

• if、while 或 until 的条件测试中；
• 与 && 或 || 连接的命令；
• 前面带有 ! 的命令。

在这些位置，Bash 故意忽略失败，以便你可以测试退出状态。命令替换或函数调用也可能掩盖失败。

Q3：set +x 中的加号是什么意思？

加号（+）关闭，减号（-）开启的选项。set -x开启跟踪，set +x关闭跟踪，因此你可以将选项作用域限定在脚本的某一部分。

Q4：我是否应该始终使用 set -euo pipefail？

这是新脚本的良好默认设置，可以及早捕获许多错误。但set -e本身有一些令人意外的边界情况。对于复杂脚本，请了解每个选项的行为，并显式处理异常情况，而不是假定脚本完全受到保护。

十二、总结

set 内建命令将 Bash 从宽容的 Shell 转变为严谨的 Shell：

将它们组合为set -euo pipefail放在脚本顶部，将跟踪调试限定在需要调试的代码块范围内，这样脚本将尽早地报错，而不是悄无声息地做错事。

命令速记卡片：

set -e              # 出错时退出
set -u              # 未定义变量报错
set -x              # 跟踪执行命令
set -euo pipefail   # 严格模式（推荐）
set +x              # 关闭跟踪
set -o              # 查看所有选项
set -- a b c        # 设置位置参数

灵活使用 set 系列参数，可彻底优化 Bash 脚本默认的宽松执行逻辑，提前拦截命令报错、变量错误、管道执行异常等各类隐患。以set -euo pipefail构建脚本严格模式，搭配局部开关实现精准调试，能够显著提升脚本的健壮性、可维护性与排错效率，是开发稳定可靠 Bash 脚本的核心最佳实践。

以上关于详解Bash set 命令：set -e、set -x 和 set -u 完全指南的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。