ShellCheck 是专为 shell 脚本设计的静态分析器，能精准识别肉眼易忽略的风险（如 SC2086、SC2154），不执行脚本、无副作用，适用于部署前校验。
ShellCheck 是什么，为什么不能只靠肉眼检查 Bash 脚本
ShellCheck 不是语法高亮插件，也不是运行时调试器，它是专为 bash、sh、dash 等 shell 脚本设计的静态分析器。运维脚本常因变量未引号包裹、$? 误判、数组误用、未声明的变量等导致线上故障，而这些在 bash -n 下可能不报错，ShellCheck 却能精准标出风险点（比如 SC2086、SC2154）。它不执行脚本，只读源码，因此不会触发副作用——这点对部署前校验特别关键。
Sublime Text 中安装 ShellCheck 插件并验证是否生效
别直接搜 “ShellCheck”，要装的是 SublimeLinter-shellcheck（依赖 SublimeLinter 主体插件）。安装顺序必须是：
- 先通过 Package Control 安装
SublimeLinter - 再安装
SublimeLinter-shellcheck - 确保系统已全局可调用
shellcheck：终端运行shellcheck --version应返回版本号；若提示 command not found，Mac 用户用brew install shellcheck，Ubuntu/Debian 用sudo apt install shellcheck - 重启 Sublime Text 后，打开任意
.sh文件，故意写一行echo $PATH（未引号），应立刻看到黄色下划线和提示SC2086
配置 ShellCheck 规则级别与忽略特定警告
默认启用全部检查，但运维脚本常需绕过某些“合理但被误报”的规则（比如硬编码路径、使用 eval 启动服务）。修改 Sublime Text 的 SublimeLinter.sublime-settings（Preferences → Package Settings → SublimeLinter → Settings）：
{
"linters": {
"shellcheck": {
"args": [
"--enable=all",
"--disable=SC2004,SC2120",
"--external-sources"
]
}
}
}
注意：--disable 后跟的是规则 ID，不是描述；--external-sources 必须开启，否则无法检测 sourced 文件里的函数定义；--enable=all 保证不漏检，比默认更严格。
ShellCheck 在真实运维场景中的典型误报与应对
它不是万能裁判，尤其在混合环境（如 systemd unit + bash + sed）下容易误报：
-
SC2148（没有 shebang）：脚本作为 source 文件被其他脚本调用时，确实不需要#!/bin/bash，此时应在文件顶部加# shellcheck disable=SC2148 -
SC2016（单引号内变量不展开）：若你明确需要字面量'$HOME'，就加# shellcheck disable=SC2016，不要强行改成双引号破坏语义 -
SC2129（多个 echo 写入同一文件未用 >>）：若脚本中是分步生成配置，每行独立 echo 是有意为之，禁用比改逻辑更安全 - 所有 disable 注释必须紧贴对应行上方，且只对下一行生效；跨多行需重复写或改用块注释
# shellcheck disable=SC2001,SC2002
真正危险的是忽略 SC2154（未定义变量）或 SC2002（cat file | grep → 直接 grep file），这两类几乎总是真问题。
