ShellCheck在Sublime Text中需先系统安装再通过SublimeLinter-shellcheck插件集成，依赖SublimeLinter核心，配置需指定shellcheck路径及参数，仅对带shebang的bash脚本生效，专注静态语法检查。
ShellCheck在Sublime Text里根本不是“安装”而是“集成”
ShellCheck本身是个命令行工具，Sublime Text不支持直接“安装”它——你得先确保系统里有 shellcheck 可执行文件，再让Sublime通过插件调用它。很多人卡在第一步：明明下载了ShellCheck二进制，却提示 command not found，其实是PATH没生效或权限不对。
- macOS上用Homebrew最稳：
brew install shellcheck，验证运行shellcheck --version - Linux（如Ubuntu）用包管理：
sudo apt install shellcheck - 手动下载二进制时，必须加可执行权限：
chmod +x shellcheck，并放到/usr/local/bin/或确保所在目录在$PATH中 - Windows用户别折腾WSL以外的路径——Sublime默认调用的是Windows原生命令行，建议直接用WSL2 + Sublime的Remote-WSL插件，否则
shellcheck.exe容易因路径空格、编码出问题
用SublimeLinter-shellcheck插件实现实时检查
单纯装好ShellCheck没用，得靠 SublimeLinter 框架和它的配套linter插件把输出接进编辑器。注意：这不是独立插件，依赖 SublimeLinter 核心，漏装会完全没反应。
- 先装
SublimeLinter：Package Control → Install Package → 输入SublimeLinter（认准作者是SublimeLinter团队） - 再装
SublimeLinter-shellcheck：同上，搜这个完整名字，别只输“shellcheck”——会有其他无关插件干扰 - 重启Sublime，打开一个
.sh文件，右下角状态栏应显示ShellCheck，否则检查SublimeLinter控制台（Ctrl+`）有没有报错，常见是找不到shellcheck路径 - 若需自定义ShellCheck版本或参数（比如禁用某类警告），在
SublimeLinter.sublime-settings里加：{ "linters": { "shellcheck": { "args": ["--enable=all", "--exclude=SC2034"] } } }
为什么有些语法错误不标红？ShellCheck的检查边界在哪
ShellCheck专注静态分析，不执行脚本，所以它查不出运行时逻辑错误、变量是否真被赋值、命令是否存在——只查语法歧义、未引号变量、危险重定向等典型陷阱。比如 rm $file 会告警 SC2086，但 rm $(bad_command) 不会报，因为展开结果无法静态预判。
- 它默认只对
#!/bin/bash或#!/usr/bin/env bash等明确指定了解释器的脚本启用；纯.sh文件若没shebang，可能静默跳过 - 数组、关联数组、bash 4.0+ 特性支持较好，但zsh/ksh语法基本不识别——别指望它检查zsh脚本
- 误报集中在路径含空格、嵌套命令替换、eval使用上；真需要绕过，用行尾注释：
echo $PATH # shellcheck disable=SC2086 - 性能上无压力：小脚本毫秒级，但超2000行可能延迟明显，此时建议关掉“on-save only”，改用手动触发（快捷键
Ctrl+Alt+L）
调试失败时优先看SublimeLinter日志而非ShellCheck输出
当界面没提示、控制台也没报错，大概率是SublimeLinter没成功调起ShellCheck进程——它不会弹窗告诉你失败，只会沉默。
- 打开Sublime控制台（
Ctrl+`），输入sublime.log_commands(True)，然后保存文件，观察是否有shellcheck相关调用记录 - 如果看到类似
Unable to locate 'shellcheck' in PATH，说明插件找的PATH和你终端里的不一样——Mac GUI应用常不继承shell的PATH，需在SublimeLinter.sublime-settings中显式指定："paths": {"linux": ["/usr/local/bin"], "osx": ["/opt/homebrew/bin"]} - Windows下路径带空格（如
C:\Program Files\...）会导致解析失败，务必用短路径（C:\tools\shellcheck\shellcheck.exe）或WSL方案 - 别用旧版Sublime Text 3 build
真正麻烦的从来不是配不配得上，而是配完了不知道它到底有没有跑起来。盯住控制台那几行日志，比反复重装插件有用得多。
