用 set -x 和 trap 组合调试 Shell 脚本最有效：set -x 实时显示命令执行（含变量展开），配合 PS4 可加行号；trap 在 ERR 时捕获错误行号、退出码、环境变量等上下文，二者结合可闭环定位问题根源。

Shell脚本出错时，光靠肉眼检查往往效率低、易遗漏。用 set -x 显示执行过程，再配合 trap 捕获异常时刻的状态，能快速定位问题根源。

用 set -x 实时追踪命令执行

set -x 会打印每条实际运行的命令（含变量展开后结果），是调试最直接的手段。它不改变逻辑，只增加输出，适合快速验证流程是否如预期。

• 在脚本开头加 set -x，整个脚本启用跟踪；也可在局部代码块前后开关：先 set -x，出问题区域结束后用 set +x 关闭
• 注意：命令中含敏感信息（如密码、token）时，set -x 会原样打印，建议临时注释或改用其他方式脱敏
• 输出前缀默认为 +，可通过设置 PS4 自定义，比如 PS4='[$LINENO] ' 能同时显示行号，方便回溯

用 trap 捕获错误发生时的上下文

trap 可在脚本退出、收到信号或命令失败时触发指定动作。搭配 set -e（遇错退出）使用，能精准抓取失败瞬间的环境快照。

• 常见写法：trap 'echo "ERROR at line $LINENO"; exit 1' ERR，让脚本在任意命令失败时立刻报告出错行号
• 更实用的做法是记录关键状态：比如 trap 'echo "Exit code: $?; PWD: $PWD; Args: $*" > /tmp/debug.log' ERR
• 若需保留退出前的变量值，可在 trap 中调用 env | grep -E "^(VAR1|VAR2)="' 这类过滤命令，避免日志过载

组合使用提升排错效率

单独用 set -x 可能看到“哪条命令跑错了”，但未必知道“为什么错”；trap 能捕获错误瞬间，却看不到完整执行路径。两者结合，才能闭环。

• 典型调试结构：开头设 set -x 和 PS4，再加 trap 记录错误详情，最后用 set +x 在关键段落关闭跟踪
• 测试阶段可导出全部输出到文件：./script.sh 2>&1 | tee debug.log，再结合 grep "+" 快速筛选执行流
• 上线前记得移除或注释掉调试语句，避免泄露信息或影响性能——尤其在循环密集或高频调用场景

替代方案与注意事项

不是所有场景都适合 set -x 或 trap。有些限制需要提前预判。

• 子 shell（如 (...) 或管道中的命令）会继承 set -x，但 trap 默认不继承，需显式用 trap -p 查看或重新设置
• 函数内局部变量在 trap 中不可见，如需调试函数状态，建议把关键变量提前导出为全局变量或用 declare -p 打印
• 对交互式脚本，set -x 的大量输出可能干扰用户，此时更适合用日志级别控制，例如通过 debug=1 参数开关调试输出