shellcheck 是主流 shell 静态分析工具，可提前发现未定义变量、结构不完整、引号缺失等导致线上崩溃的隐患；支持多系统安装，能精准定位 if/for/while 缺失闭合、变量未引号、posix 不兼容及命令状态未检查等问题，并可集成 ci、git hook 与 set -euo pipefail 提升部署可靠性。
直接用 ShellCheck（最主流的 Shell-Lint 工具）扫描部署脚本，能提前发现未定义变量、条件漏闭合、引号缺失、命令误用等导致线上崩溃的逻辑隐患——它不运行脚本，只分析代码结构和语义，是上线前最有效的“防崩”检查手段。
安装与基础扫描
ShellCheck 是开箱即用的静态分析器，无需配置即可捕获大量高危问题：
- Ubuntu/Debian 系统：sudo apt install shellcheck
- CentOS/RHEL：sudo yum install epel-release && sudo yum install ShellCheck
- macOS：brew install shellcheck
- 快速检查脚本：shellcheck deploy.sh，会逐行标出问题类型、风险等级及修复建议
重点拦截部署脚本典型逻辑陷阱
ShellCheck 对以下极易引发线上崩溃的写法有强识别能力：
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- if/for/while 结构不完整：如漏写 fi、done，报错为 “unexpected end of file”，但实际错误在几十行前；ShellCheck 明确指出缺失位置
- 变量未加引号且含空格或为空：例如 cp $SRC $DST 在 $SRC="/path/to my app" 时拆成三个参数，导致复制失败甚至覆盖错误文件；ShellCheck 提示 “quote this to prevent word splitting”
- 使用了 /bin/sh 解释器却写了 bash 特性：比如 shebang 写 #!/bin/sh，但用了 [[ ]] 或 source 高级语法，在 Ubuntu 等系统中由 dash 执行直接报错；ShellCheck 标记为 “in POSIX sh, use [ instead of [[”
- 未检查关键命令退出状态：如 wget 下载失败后继续解压，导致后续操作基于空文件出错；ShellCheck 不强制要求，但配合 set -e 使用时，会提醒你哪些命令可能失败却无处理
集成进部署流程提升可靠性
把 ShellCheck 检查变成上线前必经步骤，避免“能跑就行”的侥幸心理：
- 在 CI 流水线中加入检查：shellcheck --severity=error deploy.sh || exit 1，仅阻断严重问题，不影响开发节奏
- 本地提交前自动校验：在 Git hook（如 pre-commit）中调用 ShellCheck，问题不过不许提交
- 搭配 set -euo pipefail 使用：脚本开头加上这句，能让未定义变量、任意命令失败、管道错误全部中断执行，ShellCheck 会额外提示哪些变量未声明就使用
- 对跨平台编写的脚本，先用 dos2unix deploy.sh 清除 Windows 换行符，再交给 ShellCheck，避免格式干扰语义分析
不依赖工具也该养成的习惯
工具再强，也替代不了基本规范。这些动作成本极低，但能规避 80% 的线上崩溃：
- 所有变量引用统一加双引号："$VERSION"、"$APP_DIR"，包括 test 判断中：[ -n "$DB_HOST" ]
- 关键路径用绝对路径或显式校验：[ -d "/opt/myapp" ] || { echo "目标目录不存在"; exit 1; }
- 敏感操作前加 dry-run 模式开关：if [ "$DRY_RUN" = "true" ]; then echo "[DRY] Would copy..."; else cp ...; fi
- 用 sh -n deploy.sh 做轻量语法预检（不执行，只解析），可作为 ShellCheck 的补充快筛
