bash -n 选项用于仅检查脚本语法而不执行，可快速暴露引号不匹配、缺少 fi/done 等结构性错误，是调试运维脚本的第一道防线。
调试运维脚本里的隐藏语法错误，关键不是等它报错再修，而是提前暴露、分层拦截、精准定位。很多问题在运行前就已存在，只是没被发现。
用 bash -n 快速做语法预检
这是最轻量也最有效的第一道防线：不执行脚本，只解析语法结构。
- 运行 bash -n script.sh，它会检查 if/fi、for/done、函数括号、引号配对等基础结构是否闭合
- 报错如 unexpected end of file，基本就是漏了 fi、done 或 }；报 syntax error near unexpected token，多是括号、分号或重定向符号缺失或错位
- 适合集成进编辑保存后自动触发，或 CI 流水线中作为准入检查
开启 set -x + set -e 实时追踪执行流
让脚本“开口说话”，同时防止错误被忽略：
- 在脚本开头加 set -e：任意命令返回非 0 状态立即退出，避免失败后继续执行导致连锁问题
- 加 set -x：每行实际执行的命令（含变量展开后结果）都会带 + 号打印出来，一眼看出 $PATH 是空还是错、文件路径拼成了什么鬼样子
- 局部启用更安全：用 set -x 和 set +x 包住可疑代码段，避免敏感信息（如密码、token）在日志中泄露
用 shellcheck 扫描潜在陷阱
人工容易忽略的坑，工具能帮你揪出来：
- 安装后运行 shellcheck script.sh，它会标出未加引号的变量（
$VARvs"$VAR"）、[ 和 ] 之间必须有空格、$? 使用时机不当、危险的 eval 用法等 - 特别提醒：[[ $a == $b ]] 合法，但 [ $a == $b ] 在部分 shell 中会报错——shellcheck 能明确指出该用哪种测试形式
- 支持 Vim/VS Code 插件，写到一半就能实时提示
模拟真实执行环境复现问题
很多“本地能跑，线上挂掉”的问题，根源是环境差异：
- crontab 或 systemd service 启动脚本时，PATH 极简、HOME 可能为空、~ 不展开——用 env -i /bin/bash -l -c './script.sh' 模拟干净环境
- 检查换行符：file script.sh 若显示 CRLF，说明是 Windows 编辑器保存的，用 dos2unix script.sh 转换，否则可能报 : command not found
- 确认脚本权限：chmod +x script.sh，否则即使语法全对，也会因无法执行而卡在第一步
