shellcheck 在 sublime 中无反应，主因是 path 未正确加载或插件版本不兼容；需确认 shellcheck 路径、安装匹配版本的 sublimelinter 及插件、检查语法高亮类型、配置参数而非禁用，并确保 sublimelinter 全局启用。
ShellCheck 没反应？先确认它是否真的在 PATH 里
Sublime Text 调用 ShellCheck 的本质是执行系统命令，如果 shellcheck 命令在终端能跑通，但在 Sublime 里没输出，大概率是 Sublime 启动时没加载你的 shell 环境（尤其是 macOS / Linux 下用 zsh 或 fish 的用户）。Sublime 默认不读 ~/.zshrc 或 ~/.bash_profile，PATH 里压根没有 shellcheck。
- 在终端运行
which shellcheck，记下完整路径，比如/usr/local/bin/shellcheck - 不要依赖
shellcheck --version在 Sublime 控制台里成功就以为万事大吉——那是 Python subprocess 走的当前进程环境，和插件调用路径不是一回事 - macOS 上若用 Homebrew 安装，且终端用 zsh，记得检查
~/.zprofile是否导出了 PATH；Sublime 通常只读这个文件
用 SublimeLinter-shellcheck 插件，但别直接装最新版
官方推荐的 SublimeLinter-shellcheck 插件本身没问题，但它的 v4+ 版本强制要求 SublimeLinter 4.0+，而后者对 Sublime Text 4 的兼容有坑：某些 build（如 4169）会静默忽略 linter 配置，表现为“保存后零提示”。不是你配错了，是版本链断了。
- 稳妥做法：通过 Package Control 安装
SublimeLinter（v4.22.0 或更高），再安装SublimeLinter-shellcheck（v4.0.5 或 v4.1.0） - 如果已装最新版却无响应，先禁用插件，删掉
SublimeLinter-shellcheck的缓存目录：~/Library/Application Support/Sublime Text/Packages/User/SublimeLinter.sublime-settings里清空shellcheck相关段落，再重装 - 插件默认只对
shell-unix和bash语法高亮的文件生效，确保你打开的 .sh 文件右下角显示的是 “Bash” 而非 “ShellScript” 或 “Plain Text”
配置 shellcheck 参数：绕过误报比关掉检查更安全
ShellCheck 默认激进，比如把 for i in $(ls) 标为 SC2045，但有时你就是需要快速遍历（测试场景），硬改逻辑反而拖慢迭代。这时候该调参，而不是关插件。
- 在 Sublime 的
Preferences → Package Settings → SublimeLinter → Settings中，添加：
"linters": {
"shellcheck": {
"args": ["-e", "SC2045,SC2207", "--external-names=jq,curl"]
}
}
-e 后跟的是错误码，不是描述；SC2207 是数组展开警告，常在解析命令输出时误报--external-names 告诉 ShellCheck 这些命令是可信的（避免 SC2155），但别滥用——只填你真正在脚本里用、且确定不会被覆盖的命令名--disable 全局关检查，它会跳过所有规则，包括真正危险的 SC2086（未引号变量展开）为什么改完配置还是不标红？检查 SublimeLinter 的启用开关
很多人配完路径、参数、插件，重启 Sublime，结果保存文件依旧没任何 lint 提示——最常被忽略的是 SublimeLinter 自身的全局开关被关了。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入SublimeLinter: Toggle Linting，确保它是 “enabled” 状态 - 再输
SublimeLinter: Show All Errors，看是否有 “No errors found” 还是报错如shellcheck: command not found - 如果看到
shellcheck: unknown option -- enable，说明你用了旧版 shellcheck（brew upgrade shellcheck）
Sublime 对 shell 脚本的 lint 是异步触发的，保存瞬间没反应很正常；但如果你等两秒仍无任何提示，问题几乎一定出在 PATH、语法识别或 SublimeLinter 总开关上——而不是 ShellCheck 规则本身。
