如何快速调试Shell脚本

快速调试 Shell 脚本，核心目标是：定位问题、减少试错、提高效率。下面按“从快到慢、从简单到专业”的方式给你一套实用方案。

一、最快上手：使用 set -x（强烈推荐）

1️⃣ 在脚本中开启调试

#!/bin/bash
set -x   # 开启调试
set -e   # 遇到错误立即退出（可选）

echo "start"
ls /not_exist
echo "end"

输出示例：

+ echo start
start
+ ls /not_exist
ls: cannot access /not_exist: No such file or directory

✅ 优点：

• 立竿见影
• 能看到每一行实际执行的命令

2️⃣ 只调试某一段

set -x
# 要调试的代码
set +x

二、执行时直接调试（不用改脚本）

1️⃣ 用 -x

bash -x script.sh

2️⃣ 同时显示行号（更清晰）

bash -xv script.sh

参数说明：

• -x：打印执行命令
• -v：打印脚本内容

三、显示行号 + 错误信息（定位错误位置）

1️⃣ 在脚本开头加

#!/bin/bash
set -e
trap 'echo "Error on line $LINENO"; exit 1' ERR

2️⃣ 显示当前执行行号

PS4='+ Line ${LINENO}: '
set -x

输出示例：

+ Line 10: echo start

✅ 非常适合长脚本、复杂逻辑

四、快速定位：echo / printf（最常用）

1️⃣ 打印变量

echo "VAR=$VAR"

2️⃣ 打印函数入口

func() {
  echo "func() called"
}

✅ 适合：

• 快速确认变量值
• 判断代码是否执行到某处

⚠️ 缺点：调试完要删

五、调试条件判断（非常容易出错）

1️⃣ 打印判断条件

echo "a=$a b=$b"
if [ "$a" = "$b" ]; then
  echo "equal"
fi

2️⃣ 防止空变量错误

[ "$VAR" = "yes" ]   # ✅
[ $VAR = "yes" ]     # ❌

六、调试函数（推荐方式）

f() {
  echo ">>> f() start"
  set -x
  # 逻辑
  set +x
  echo "<<< f() end"
}

七、常用调试组合（实战推荐）

✅ 标准调试模板

#!/bin/bash
set -euo pipefail
PS4='+ Line ${LINENO}: '
set -x

解释：

• set -e：出错即停
• set -u：用未定义变量直接报错
• set -o pipefail：管道中任一失败即失败

八、进阶工具（可选）

1️⃣ bashdb（类似 gdb）

bashdb script.sh

功能：

• 单步执行
• 设置断点

⚠️ 学习成本高，不常用

九、调试思路总结（很重要）

✅ 调试顺序建议：

1. 用 bash -x 看执行流程
2. 看变量值是否正确
3. 看条件判断是否写错
4. 看路径、权限、引号问题

✅ 90% 的 Shell 脚本错误来自：

• 变量未加引号
• 空格问题
• 路径错误
• 条件判断写错

十、如果你愿意，我可以直接帮你

你可以直接发我：

• 脚本内容
• 报错信息
• 想实现的功能

我可以 逐行帮你定位问题并给出修改版脚本 ✅