DevOps Bootcamp · 课时

调试 Bash 脚本（set -x、trap）

Q: 「调试 Bash 脚本（set -x、trap）」这节课中我会学到什么？

探索调试 Bash 脚本的方法，包括跟踪执行过程，以及使用“trap”处理错误。 你通过在浏览器中直接运行的动手代码来练习 DevOps Bootcamp，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

探索调试 Bash 脚本的方法，包括跟踪执行过程，以及使用“trap”处理错误。

调试 Bash 脚本（set -x、trap） 是 CoddyKit 上的免费 DevOps Bootcamp 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 DevOps Bootcamp 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 DevOps Bootcamp 课程共包含 4 节课。

为什么要调试脚本？

即使最优秀的脚本也可能存在错误！调试是查找并修复这些错误的过程。

这对任何开发人员来说都是一项重要技能，可以帮助您逐步了解脚本的执行过程，以及问题可能出现的位置。

在本课中，您将学习功能强大的 Bash 工具，用于跟踪执行过程并处理意外事件。

使用 `set -x` 跟踪脚本

Bash 中最简单、最有效的调试工具之一是 set -x。它可以启用命令跟踪。

启用后，Bash 会在执行每条命令之前，将命令及其参数打印到标准错误（通常就是您的终端）。
这些输出包括变量展开后的状态，让您清楚地看到 Bash 接下来要执行的内容。
这就像观看脚本以慢动作执行一样！

查看 `set -x` 的效果

让我们看看 set -x 的实际效果。请注意，shell 会在变量展开后打印每条命令，并在前面加上 + 号。

请尝试运行以下示例：

#!/bin/bash

# Enable command tracing
set -x

NAME="Coddy"
MESSAGE="Hello, $NAME!"

echo $MESSAGE

# This command will intentionally fail
ls -l /nonexistent_directory

# Disable command tracing
set +x

echo "Tracing is now off."

理解跟踪输出

启用 set -x 后，您会看到以 + 符号开头的行。这表示跟踪输出。

+ 后面是 Bash 即将执行的命令，以及完成变量或命令替换后的参数。
这对于查看变量的确切值以及实际执行的具体命令非常有用。
它可以帮助您定位路径错误、变量为空或命令结构意外等问题。

控制 `set -x` 的作用范围

您不一定需要跟踪整个脚本。您可以只对特定部分启用 set -x：

使用 set -x 打开跟踪。
使用 set +x 关闭跟踪。

这样，您就可以将调试工作集中在脚本中有问题的部分，而不会被稳定部分产生的输出淹没。

使用 `trap` 处理事件

trap 命令可以捕获信号和其他事件，并在这些事件发生时执行命令。它适用于：

清理：确保临时文件被删除。
错误处理：响应执行失败的命令。
平稳退出：处理 Ctrl+C 等用户中断。

基本语法是 trap 'command_to_execute' SIGNAL_OR_EVENT。

使用 `trap EXIT` 执行清理

EXIT 伪信号比较特殊。使用 EXIT 捕获的命令会在脚本终止前运行一次，无论脚本以何种方式退出（成功、失败还是被中断）。

这非常适合执行清理任务，例如删除临时文件。请尝试运行以下脚本：

#!/bin/bash

TEMP_FILE="/tmp/coddy_temp_$(date +%s).txt"

# Trap the EXIT signal to remove the temp file
trap 'echo "Cleaning up: Removing $TEMP_FILE"; rm -f "$TEMP_FILE"' EXIT

echo "Script started. Creating temporary file..."
touch "$TEMP_FILE"
echo "Temporary file created: $TEMP_FILE"

# Simulate some work
sleep 2

echo "Script logic completed. Exiting..."

使用 `trap ERR` 捕获错误

当命令以非零状态退出（也就是执行失败）时，ERR 伪信号会被触发。这样，您就可以专门在发生错误时执行相应操作。

注意：只有当命令不属于 if、while 或 until 条件，并且其返回值未被显式检查时，trap ERR 才会生效（例如 command || true）。

#!/bin/bash

# Trap ERR to report the error line number
trap 'echo "Error detected on line $LINENO! Exiting."' ERR

echo "Starting script with an intentional error..."

# This command will fail and trigger the ERR trap
ls /this/path/does/not/exist

echo "This line will NOT be reached if an error occurs."

响应信号（INT、TERM）

trap 还可以捕获标准 Linux 信号。常见信号包括：

INT（中断）：在您按下 Ctrl+C 时发送。
TERM（终止）：请求某个进程平稳终止。

捕获这些信号后，脚本可以在关闭前执行清理或保存状态，而不是突然退出。

#!/bin/bash

# Trap INT (Ctrl+C) to exit gracefully
trap 'echo "\nCaught Ctrl+C! Exiting gracefully..."; exit 1' INT

echo "Running a continuous task. Press Ctrl+C to stop."

while true; do
  echo "Working... $(date)"
  sleep 3
done

调试检查

让我们检查一下您对 Bash 调试技术的理解。

回顾：调试脚本

做得很好！您已经学会了用于调试 Bash 脚本的重要工具：

set -x：启用命令跟踪，让您准确了解 Bash 执行了什么。使用 set +x 可以将其关闭。
trap：允许您针对特定事件或信号执行命令。
`trap EXIT`：确保在脚本结束前执行清理任务。
`trap ERR`：捕获以非零状态退出的命令。
`trap INT`/`TERM`：平稳处理用户中断或终止请求。

掌握这些技术后，您排查问题和创建健壮 Bash 脚本的能力将得到显著提升！

常见问题解答

「调试 Bash 脚本（set -x、trap）」课时是免费的吗？

是的 — 「调试 Bash 脚本（set -x、trap）」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 DevOps Bootcamp 课程的其余内容，请升级到 CoddyKit PRO。 DevOps Bootcamp 课程共包含 4 节课。

「调试 Bash 脚本（set -x、trap）」这节课中我会学到什么？

探索调试 Bash 脚本的方法，包括跟踪执行过程，以及使用“trap”处理错误。你通过在浏览器中直接运行的动手代码来练习 DevOps Bootcamp，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 DevOps Bootcamp 需要有经验吗？

无需任何先前经验。CoddyKit 上的 DevOps Bootcamp 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「调试 Bash 脚本（set -x、trap）」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 DevOps Bootcamp 课中编写并运行代码吗？

能。每节 DevOps Bootcamp 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 DevOps Bootcamp