掌握调试技巧可快速定位Linux脚本问题，首先启用set -x查看命令执行过程，结合echo输出变量值并重定向到标准错误；使用bash -n检查语法，ShellCheck分析潜在错误；注意权限、换行符、路径及变量引用问题，确保条件判断中空格正确，通过合理工具与习惯提升调试效率。
调试 Linux 脚本是编写 Shell 脚本过程中不可避免的一环。当脚本运行出错或结果不符合预期时，掌握有效的调试方法能快速定位问题并修复。下面介绍几种常用的 Linux 脚本调试技巧和常见问题的解决方式。
启用 Shell 的调试模式
Shell 提供了内置的调试选项，可以通过命令行参数或脚本内部设置来开启。
-
-x 选项：显示每条命令执行前的展开形式，有助于查看变量替换后的实际命令。可以在运行脚本时使用：
bash -x script.sh -
在脚本中使用 set 命令：在脚本开头或某段代码前后插入：
set -x 开启调试输出
set +x 关闭调试输出 -
更严格的模式：
set -e 遇到错误立即退出
set -u 使用未定义变量时报错
set -o pipefail 管道中任一命令失败即视为整体失败
打印关键变量和执行路径
在关键位置添加 echo 或 printf 输出变量值和流程信息，是最直接的调试手段。
- 检查变量是否赋值正确，比如：
echo "DEBUG: value of FILE is '$FILE'" - 标记代码执行到了哪一步：
echo "INFO: Starting backup process..." - 避免干扰正常输出，可将调试信息重定向到标准错误：
echo "DEBUG: count = $count" >&2
检查语法和潜在问题
在运行脚本前先做静态检查，可以避免低级错误。
- 使用 bash -n script.sh 检查语法错误，不执行脚本
- 使用 ShellCheck 工具（需安装）进行深度分析：
shellcheck script.sh
它能提示引用问题、未加引号的变量、拼写错误等 - 确保脚本首行指定了正确的解释器，如：
#!/bin/bash 或 #!/bin/sh
常见问题与解决方案
实际调试中常遇到一些典型问题，了解其成因有助于快速处理。
- 权限拒绝：确保脚本有执行权限，使用 chmod +x script.sh
- 换行符问题：Windows 编辑的脚本可能包含 ^M 字符，用 dos2unix script.sh 转换
- 路径问题：脚本中使用的命令或文件路径应尽量使用绝对路径，或确保 PATH 设置正确
- 变量未加引号导致解析错误：含有空格的变量应始终加双引号，如 "$filename"
- 条件判断失败：注意 [ ] 中空格的使用，字符串比较建议用 [[ ]] 更安全
