Linux Shell调试技巧讲解_Linux排查脚本报错的方法

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可关闭某段跟踪，避免信息过载

检查变量和状态码，揪出空值与失败命令

很多报错其实不是语法问题，而是变量为空、文件不存在、命令失败却没处理。

标签： linux 工具 ai 状态码 shell脚本