调试 shell 脚本的关键方法包括：1. 使用 bash -x 或 set -x 查看执行过程，适用于检查变量赋值和执行流程；2. 利用 trap 命令捕获错误信息，可显示错误行号和命令；3. 检查退出状态码并记录日志，帮助识别关键步骤失败；4. 使用 sh -n 和 shellcheck 提前发现语法和潜在问题。掌握这些技巧能有效提升脚本调试效率并快速定位问题根源。
调试 Shell 脚本在 Linux 环境中是一个很常见的需求，尤其是当脚本运行不按预期执行时。掌握一些基本的调试方法和错误捕获技巧，能帮助你快速定位问题所在。
使用 bash -x 或 set -x 查看执行过程
这是最直接的调试方式。通过开启“追踪”模式，可以看到脚本每一行实际执行的内容，包括变量替换后的值。
你可以直接在运行脚本时加上 -x 参数：
bash -x your_script.sh
或者，在脚本内部加上：
set -x
这样就能看到每一步命令的执行情况了。如果你只想查看部分代码块的执行，可以配合 set +x 来关闭追踪：
set -x # 想调试的代码段 set +x
这种方式特别适合检查变量是否正确赋值、条件判断是否成立等问题。
利用 trap 命令捕获错误信息
有时候脚本出错后就直接退出了，很难知道哪里出了问题。可以用 trap 命令来设置一个“钩子”，在脚本出错时输出更多信息。
比如下面这个例子，会在脚本出错时打印出错行号和对应的命令：
trap 'echo "Error on line $LINENO: $BASH_COMMAND"' ERR
将这段代码加到脚本开头，就可以在出错时得到更具体的提示。这对排查逻辑分支中的隐藏问题很有帮助。
如果你想让脚本在出错时不立即退出，而是继续执行后续的清理操作，还可以结合 set -e（遇到错误终止）和 trap 一起使用。
检查退出状态码并记录日志
每个命令执行完都会返回一个退出状态码（exit code），0 表示成功，非零表示出错。你可以通过 $? 来获取上一条命令的状态码。
例如：
some_command if [ $? -ne 0 ]; then echo "some_command failed" fi
这在写自动化脚本时非常有用。你可以在关键步骤后面加上这样的判断，及时发现失败点。
另外，建议把调试信息或错误信息记录到日志文件中，而不是只打印在终端上。比如：
exec > >(tee -a script.log) 2>&1
这样可以让脚本的标准输出和错误输出都保存下来，方便后续分析。
小贴士：使用 sh -n 和 shellcheck 提前发现问题
在运行脚本之前，可以用 sh -n 检查语法是否有错误：
sh -n your_script.sh
它不会执行脚本，只是做语法检查，适合用于初步验证脚本是否写对。
还有一个更好的工具是 shellcheck，它可以检测出更多潜在的问题，比如未引用的变量、拼写错误等。很多编辑器也支持集成这个工具，提前发现隐患。
基本上就这些常用的方法了。调试 Shell 脚本其实不需要太复杂的工具，关键是理解脚本的执行流程和错误发生的位置。把这些技巧组合起来，大多数问题都能找到根源。
