装完sublimelinter-shellcheck没反应，主因是shellcheck未安装或路径未配置：需系统级安装shellcheck并确认command可用；sublime中须手动配置executable路径；语法必须设为shellscript；建议调整lint_mode和delay提升响应；还需清除bom、统一缩进以避免误报。
装完 SublimeLinter-shellcheck 后没反应？不是插件坏了，而是 shellcheck 没被找到，或者根本没装——这是 90% 的人卡住的第一步。
shellcheck 必须先装系统级二进制，不能只装 Sublime 插件
SublimeLinter-shellcheck 只是“调度器”，它不带 shellcheck 本体。你必须在终端里确认 shellcheck 命令能直接运行：
- Ubuntu/Debian：
sudo apt install shellcheck - macOS（Homebrew）：
brew install shellcheck - CentOS/RHEL：用
cabal install shellcheck（注意路径默认在~/.cabal/bin/shellcheck） - 装完后执行
shellcheck --version，有输出才算成功
如果报 command not found，SublimeLinter 就会静默失效——连错误提示都不给，只会“没反应”。
SublimeLinter-shellcheck 路径配置常被忽略
尤其当你用 pyenv、rbenv 或 cabal 安装的工具，shellcheck 很可能不在系统 $PATH 默认路径里（比如 /usr/bin 或 /usr/local/bin）。这时必须手动指定：
- 打开 Sublime →
Preferences → Package Settings → SublimeLinter → Settings - 在用户设置里加这段（以 macOS + cabal 为例）：
{
"linters": {
"shellcheck": {
"executable": ["/Users/xxx/.cabal/bin/shellcheck"]
}
}
}
Windows 用户注意路径用正斜杠或双反斜杠："executable": ["C:/Users/xxx/AppData/Roaming/cabal/bin/shellcheck.exe"]；路径错一个字符，linter 就完全不启动。
Shell 文件语法识别必须是 ShellScript，不是 Plain Text
右下角状态栏显示 Plain Text 或 Text？那 shellcheck 根本不会触发。必须让 Sublime 知道这是 Shell 脚本：
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac） - 输入
Set Syntax: ShellScript，回车选中 - 更稳妥的做法：文件首行是
#!/bin/bash或#!/usr/bin/env sh，保存后 Sublime 通常自动识别
如果文件扩展名不是 .sh（比如叫 deploy 或 backup），就得靠手动设语法，否则 lint 链路从第一步就断了。
实时扫描依赖 lint_mode 和 delay，别指望“敲完立刻标红”
默认 SublimeLinter 是 background 模式，但 shellcheck 对小脚本响应快，对含复杂变量展开或子 shell 的脚本可能卡顿。若发现高亮延迟严重或编辑时 CPU 占用突增：
- 在 SublimeLinter 用户设置里加这两项：
{
"lint_mode": "load_save",
"delay": 0.3
}
load_save 表示只在加载和保存时检查，适合写完再扫；delay 是编辑时背景检查的等待毫秒数，设太小（如 0.1）会频繁调用 shellcheck，设太大（如 2.0）就失去实时感。0.3 是多数 Shell 脚本的平衡点。
真正容易被忽略的是：shellcheck 本身不处理 BOM、混合缩进或 CRLF 换行符。如果报错位置总偏移一行，先用 File → Reopen with Encoding → UTF-8 清掉 BOM，再用 View → Indentation → Convert Indentation to Spaces 统一缩进——这些底层文本问题，比 linter 配置更常导致“误报”或“漏报”。
