调试shell脚本的关键在于使用bash -x和set -e。一、bash -x可查看每行命令及变量展开结果,便于定位问题,亦可在脚本首行添加#!/bin/bash -x启用调试模式。二、set -e让脚本遇错即停,避免错误扩散,但需临时关闭时可用set +e再恢复。三、结合两者效果更佳,既显示执行流程又及时终止错误,也可动态控制调试范围以减少日志量。
写shell脚本时,调试是个绕不开的环节。尤其是脚本逻辑复杂或运行环境多变的时候,光靠打印echo信息效率太低。常用的调试方式就是用bash -x和set -e这两个工具配合使用,能帮你快速定位问题。
一、用bash -x查看脚本执行过程
bash -x 是最直观的调试方式,它会在执行脚本时把每一行命令以及变量展开后的结果都打印出来,适合用来观察脚本实际是怎么跑的。
比如你有个脚本叫 test.sh,直接运行:
bash -x test.sh
你会看到类似这样的输出:
+ echo 'Hello World' Hello World
前面的 + 表示当前执行的命令。这样你就能看到哪一行出了问题,或者变量有没有被正确替换。
如果你不想每次都加 -x,也可以在脚本第一行加上:
#!/bin/bash -x
这样脚本一运行就会自动进入调试模式。
二、用set -e让脚本出错就退出
默认情况下,Shell脚本遇到错误会继续往下执行,这有时会让你误以为整个流程是成功的,其实中间某个关键步骤已经失败了。
这时候可以用 set -e,它的作用是:一旦某条命令返回非0状态码(也就是出错了),整个脚本立刻停止执行。
用法很简单,在脚本开头加上:
#!/bin/bash set -e
比如你写了这么一段:
rm /tmp/nonexistent_file.txt echo "File removed"
如果文件不存在,rm 会报错但脚本还是会继续输出”File removed”。加上 set -e 后,脚本会在rm失败时立即退出,避免后续逻辑出错。
不过要注意的是,有些命令即使失败也想继续执行,比如你想判断某个命令是否存在:
if ! command -v some_tool >/dev/null; then echo "some_tool not found" fi
这种情况下要临时关闭 -e,可以这样写:
set +e command -v some_tool >/dev/null result=$? set -e
这样就不会因为命令失败而中断脚本。
三、结合使用更有效
单独用 -x 可以看执行流程,单独用 -e 可以防止错误扩散。两者结合起来调试效果更好。
你可以同时启用它们,比如:
#!/bin/bash -x set -e
或者在脚本中分开写:
#!/bin/bash set -x set -e
这样脚本运行时既能看到每一步的执行情况,又能在出错时及时停下来。非常适合用于CI/CD脚本、部署脚本等对可靠性要求较高的场景。
有时候你只想在部分代码段开启 -e 或者 -x,也可以动态控制,比如:
set -x # 开启调试 # 这里是一些关键操作 set +x # 关闭调试
这种方式可以减少日志量,只关注你想看的部分。
基本上就这些。调试Shell脚本不难,关键是用好工具,理清逻辑。bash -x和set -e虽然简单,但搭配起来非常实用。