sublime启动后shellcheck无反应，首要排查path是否真正生效、插件版本链是否匹配（sublimelinter v4.22.0+ + shellcheck插件v4.0.5/v4.1.0）、文件语法类型是否正确设为bash而非plain text。
Sublime 启动后 ShellCheck 完全没反应？先查 PATH 是否真正生效
Sublime Text 启动时不会自动加载你的 shell 配置文件（比如 ~/.zshrc 或 ~/.bash_profile），所以即使终端里能跑 shellcheck --version，插件也可能根本找不到它。这不是插件坏了，而是环境没通。
- 在终端执行
which shellcheck，记下完整路径，例如/usr/local/bin/shellcheck - macOS 用户重点检查
~/.zprofile是否导出了 PATH；Sublime 只读这个文件，不读~/.zshrc - Windows 用户需确认
shellcheck.exe所在目录已加入系统环境变量PATH，且重启了 Sublime（改完环境变量必须重启） - 别信 Sublime 控制台里
import subprocess; subprocess.run(["shellcheck", "--version"])成功——那是 Python 进程的环境，和 SublimeLinter 调用路径无关
装了插件却零提示？版本链断裂是主因
SublimeLinter-shellcheck v4+ 强制依赖 SublimeLinter 4.0+，但 Sublime Text 4 的某些 build（如 4169）会静默忽略 linter 配置，表现为“保存后没任何标红或提示”。不是你配置错了，是底层兼容断了。
- 稳妥组合：
SublimeLinterv4.22.0 或更高 +SublimeLinter-shellcheckv4.0.5 或 v4.1.0 - 已装最新版却失效？先禁用插件 → 删除
~/Library/Application Support/Sublime Text/Packages/User/SublimeLinter.sublime-settings中所有shellcheck相关段落 → 重启 Sublime → 重装指定版本 - 插件默认只对语法高亮为
shell-unix或bash的文件生效；右下角显示Plain Text或ShellScript就不会触发检查
提示出来了但全是误报？shebang 和 shell 类型没对上
ShellCheck 默认按 bash 解析，如果你脚本第一行是 #!/bin/sh 却用了 [[，它就会标红——不是 bug，是类型错配。强行屏蔽警告不如让解析器认对目标 shell。
- 确保脚本开头有明确 shebang，例如
#!/usr/bin/env bash或#!/bin/sh - 若 shebang 缺失或模糊，在
SublimeLinter.sublime-settings中显式指定："shell": "sh"或"shell": "bash" - 避免全局禁用检查；想绕过个别警告（比如
SC2086），用"excludes": ["SC2086"]，而不是关掉整个插件 - 参数传入要走
"args": ["-e", "SC2034", "-f", "gcc"]这种格式，别写成字符串拼接
为什么改了设置还是不标红？文件语法类型和插件激活条件被忽略了
SublimeLinter-shellcheck 不是“装上就自动扫所有 .sh 文件”，它严格依赖文件当前激活的语法类型。哪怕你双击打开一个 .sh 文件，右下角显示的是 Plain Text，插件压根不会加载。
- 打开 .sh 文件后，点击右下角语言标识 → 搜索
bash→ 选Bash（不是ShellScript） - 永久生效：在 Settings → Preferences → Settings 中添加：
"files.associations": {"*.sh": "bash"} - 确认
SublimeLinter全局启用："sublimelinter": true必须存在且为true，否则子插件全部静默 - 检查是否启用了
"lint_mode": "background"；设成"on_save"会导致编辑时不提示，只在保存瞬间闪一下
