sublime text 需 shellcheck cli + sublimelinter-shellcheck 插件协同工作，缺一不可；必须确保文件语法类型为 source.shell、插件启用、path 中可调用 shellcheck，否则静默无提示。
Sublime Text 本身不带 Shell 脚本静态检查能力，必须靠 ShellCheck CLI 工具 + SublimeLinter-shellcheck 插件协同工作；缺任一环，编辑器里就完全没波浪线、没提示、也不报错——不是“没效果”，而是“链路断了直接静默跳过”。
为什么装了 SublimeLinter 却没任何红色下划线
这不是配置太简陋，而是 SublimeLinter 对 Shell 脚本的检查依赖三重匹配：文件语法类型必须是 source.shell（不是 source.bash 或 source.sh），插件必须是 SublimeLinter-shellcheck（不是通用 SublimeLinter），且系统 PATH 中必须能直接调用 shellcheck 命令。
- 右下角状态栏显示 “Bash” 或 “Shell-Unix-Generic” 不代表作用域正确——打开控制台（
Ctrl+`），输入view.scope_name(0)，确认返回值含source.shell - 终端执行
shellcheck --version必须有输出；Windows 用户若用 WSL，需确保 Sublime 运行在 WSL 环境下，或显式配置executable指向\wsl$Ubuntuusrinshellcheck类路径 -
SublimeLinter-shellcheck不会自动启用，需在Preferences → Package Settings → SublimeLinter → Settings中确认"linters": {"shellcheck": {"enable": true}}
SublimeLinter-shellcheck 的关键配置项
默认配置往往忽略 Shell 特有的语义上下文，比如数组展开、[[ ]] 判断、$(()) 算术扩展等，导致误报或漏报。实际生效的最小必要配置只有两处：
-
"args": ["-x", "-e", "SC2154,SC2086"]：开启 shell 展开（-x）并屏蔽两个高频误报规则（未定义变量、未引号变量），避免干扰主线逻辑 -
"excludes": ["*.md", "deploy/*"]：排除文档和已验证的部署脚本目录，防止 lint 卡顿或污染结果 - 不要设
"paths"手动指定 shellcheck 路径——只要shellcheck在 PATH，SublimeLinter 就能自动发现；硬编码反而在切换环境时失效
常见误报 SC2086 和 SC2154 怎么处理
SC2086（未引号变量展开）和 SC2154（引用未定义变量）是 ShellCheck 最常触发的两条警告，但它们并非总该修复：
-
SC2086在明确需要单词拆分时合理，比如cmd $args传参给外部命令；此时加引号反而出错，应改用set -f; cmd $args; set +f或直接禁用该行：# shellcheck disable=SC2086 -
SC2154多见于 sourced 配置文件（如.env）中变量被主脚本引用，但 SublimeLinter 无法感知 source 关系；解决方式不是硬赋默认值，而是在 lint 配置中加"env": {"SOURCED_VARS": "1"}并配合注释说明 - 全局禁用这两条规则风险高，容易掩盖真实问题；推荐只在具体行加
disable注释，且必须附带简短理由，如# shellcheck disable=SC2086 # args intended to split
真正难处理的不是报错本身，而是 SublimeLinter 把 shellcheck 当作黑盒调用，不暴露 AST 解析过程——当你看到一条 SC 编号却不确定它是否该被信任时，最稳的办法是切到终端，手动跑 shellcheck -f gcc yourscript.sh，对照原始错误位置和上下文再判断。
