调试shell脚本最有效方式是启用可观察性：用set -x跟踪命令执行、bash -n检查语法、set -u捕获未定义变量，配合set -e和pipefail形成健壮调试习惯。
调试 Shell 脚本最直接有效的方式，是让 shell 自己“说出它在做什么”。关键不在于写得有多巧，而在于让执行过程可观察、可追溯、可中断。
用 -x 开启命令跟踪
在脚本开头加上 set -x（或运行时加 -x 参数），shell 会把每条实际执行的命令及其展开后的结果打印到标准错误。这对排查变量未赋值、路径拼接错误、通配符失效等问题特别有用。
- 推荐写法：#!/bin/bash
set -x —— 调试完成后删掉或注释掉 - 想局部启用？用 set -x 和 set +x 包裹关键段落
- 注意：函数调用、条件判断中的命令、循环体都会被显示，输出可能较密，可配合 set -v（显示原始输入行）交叉验证
用 -n 检查语法，避免运行时报错才暴露问题
bash -n script.sh 不执行脚本，只做语法解析。能提前发现括号不匹配、if/fi 缺失、未闭合引号、$(( )) 算术表达式错误等低级但致命的问题。
- 适合在编辑后、提交前、CI 流程中作为轻量检查项
- 注意：-n 不检查命令是否存在、变量是否定义、文件是否可读——它只管语法合法，不管逻辑通不通
利用 set -u 捕获未定义变量使用
默认情况下，引用未声明的变量（如 $UNSET_VAR）只会展开为空字符串，常导致静默错误（比如 rm -rf $DIR/* 中 $DIR 为空，变成 rm -rf /*）。启用 set -u 后，任何对未设置变量的引用都会立即报错退出。
- 建议与 set -e（命令失败即退出）搭配使用：set -euo pipefail
- 需引用可能为空的变量时，显式写成 ${VAR:-} 或 ${VAR:?err_msg}（未定义则报错并提示）
善用临时输出和调试钩子
复杂逻辑（如嵌套循环、状态机、多分支条件）光靠 set -x 可能信息过载。此时可在关键节点插入带上下文的调试语句：
- echo "DEBUG: i=$i, file=$file, status=$(stat -c '%U' "$file" 2>/dev/null)"
- 用 trap 'echo "At line $LINENO: i=$i, ret=$?";' ERR 捕获任意命令失败时的状态
- 将调试输出重定向到文件或独立终端，避免干扰正常输出：exec 3>&1; echo "debug info" >&3
不复杂但容易忽略：调试不是越 verbose 越好，而是要让问题浮现得足够早、足够准。从 bash -n 和 set -euo pipefail 养成习惯，再按需打开 -x，多数 Shell 脚本问题都能快速定位。
