15.2 脚本调试技巧：bash -x、echo 调试、set 指令

Shell 脚本调试并不需要专门的集成开发环境，Bash 本身内置了足够实用的跟踪与排查手段。掌握以下三种基础方法，足以应对绝大多数的日常调试场景。

1. bash -x：让脚本执行过程一目了然

-x 选项是 Bash 提供的最直接的执行跟踪工具。当用 bash -x script.sh 运行脚本时，Bash 会在每一条命令实际执行之前，将其展开之后的内容打印到标准错误输出，行首以 + 号标记。这样你就能看到变量被替换、通配符被展开、命令替换被执行之后的真实命令。

例如，假设脚本 test.sh 内容如下：

#!/bin/bash
name="world"
echo "Hello, $name"

使用 bash -x test.sh 运行，会看到类似输出：

+ name=world
+ echo 'Hello, world'
Hello, world

从输出中可以清晰地看到变量 $name 已经被替换成了 world，且 echo 命令接收到的参数是 'Hello, world'。这在命令因变量为空或包含空格导致意外行为时尤其有用，因为你可以直接观察到错误的分词和参数展开。

如果脚本较长，只想跟踪其中一部分，也可以在执行过程中用 set -x 开启跟踪，用 set +x 关闭跟踪。

2. 传统的 echo 调试：简单却不简陋

在关键位置插入 echo 语句打印变量值或简单的流程标记，是最直接的调试思路。它无需记忆额外选项，适合快速验证假设：

echo "DEBUG: 当前用户是 $USER"
echo "DEBUG: 配置文件路径为 $CONFIG_PATH"

为了避免调试信息混入正常输出，可以把它们统一输出到标准错误：

echo "DEBUG: 数据行数: $line_count" >&2

在条件分支或循环中，打印简单的“进入分支A”、“循环第 $i 次”一类信息，有助于快速确认脚本的实际执行路径。虽然这种方法比较朴素，但在排查逻辑错误时往往比其他复杂手段更快见效。

3. set 指令：细粒度控制脚本行为

set 命令可以在脚本内部动态开关 Bash 的多种行为选项，是重要的调错和防御性编程工具。除了开启跟踪的 set -x 外，以下几个选项在实际使用中尤其关键：

  set -u
  echo $UNDEFINED_VAR  # 将报错："UNDEFINED_VAR: unbound variable"

set -e：如果任何一条管道中的命令、普通的命令或循环体返回非零退出状态（即执行失败），脚本立即终止。这可以避免错误被静默传递，让脚本在第一时间暴露问题。不过需要注意，某些命令（如 grep 未匹配到内容时会返回 1）会导致脚本意外退出，此时可以用 || true 临时处理：

  set -e
  grep "pattern" file.txt || true  # 即使未找到也不会终止脚本

set -o pipefail：管道默认只返回最后一条命令的退出状态，加上此选项后，管道中任何一条命令失败都会导致整个管道被视为失败，配合 set -e 使用更为严谨。

  set -eo pipefail
  cat non_existing_file | sort   # 脚本会因 cat 失败而终止

在编写较为复杂或用于生产环境的脚本时，通常建议在脚本开头加上：

set -euo pipefail

相当于同时开启了：命令失败即退出、未定义变量报错、管道中任一命令失败即整体失败。这能从一开始就避免大量潜在错误，配合 set -x 可以快速定位问题点。

总结：调试 Bash 脚本的典型流程往往是先用 bash -x 全览执行过程，遇到具体可疑变量时在代码中插入 echo 语句输出关键状态，最后用 set 选项加固脚本的健壮性。这些工具内置于 Bash，无需安装任何额外软件，随用随取，是每个 Shell 使用者都应熟练掌握的基础技能。