Shell脚本调试靠五种基础手段：用bash -n检查语法、-x开启执行跟踪、检查$?状态码、变量加双引号、启用set -euo pipefail严格模式，可覆盖90%日常问题。
Shell脚本出错时，别急着重写，大多数问题靠几条基础调试手段就能快速定位。关键不是“猜”，而是让脚本自己“说话”。
用 -n 检查语法，不执行也能发现问题
这是最安全的第一步：只读脚本、不运行，专查语法硬伤。
-
命令写法：
bash -n script.sh—— 报错行号直接指出缺引号、少fi、括号没闭合等 - 比如
echo "Today's Date: $(date)少了一个"，-n会立刻提示unexpected EOF - 适合在修改后、提交前或部署前做快速“体检”
用 -x 开启执行跟踪，看清每一步怎么跑的
当脚本能跑但结果不对，或者中途静默退出，-x就是你的“慢动作回放”。
-
两种用法：
bash -x script.sh（临时调试） 或脚本开头加set -x（局部启用） - 输出里每行带
+号，显示变量实际展开值，比如+ cp /tmp/file.txt /home/user/，一眼看出路径是否拼错 - 搭配
set +x可关闭某段跟踪，避免信息过载
检查变量和状态码，揪出空值与失败命令
很多报错其实不是语法问题，而是变量为空、文件不存在、命令失败却没处理。
- 用
[ -z "$var" ]判断变量是否为空，避免rm $file变成rm（删当前目录） - 始终用双引号包裹变量：
"$file"而不是$file，防止含空格路径被拆成多个参数 - 执行关键命令后立刻看
$?：cp source dest || { echo "cp failed: $?"; exit 1; }
加防御性检查，把错误挡在发生前
与其等报错再修，不如提前拦住常见坑。
- 创建目录前加
[ ! -d "$dir" ] && mkdir -p "$dir" - 读文件前加
[ -f "$input" ] || { echo "输入文件不存在"; exit 1; } - 脚本开头加
set -euo pipefail（严格模式）：未定义变量、命令失败、管道中间出错都会立即终止
基本上就这些。不需要复杂工具，-n、-x、$?、引号和set -euo pipefail这五样，覆盖了90%的日常排查场景。
