ShellCheck不会自动生效，必须配齐插件、CLI、路径、语言模式四要素：安装启用插件并重启VSCode；安装shellcheck CLI并配置executablePath；将.sh文件关联为Shell Script语言模式；确保shellcheck.enable和runOnSave均为true。
ShellCheck 不会自动生效，必须手动配齐插件、CLI、路径、语言模式四要素，缺一不可。
ShellCheck 插件装了但没反应？先确认它真在跑
VSCode 默认不激活 ShellCheck，装完插件不等于就绪。右下角状态栏没显示 ShellCheck，说明它根本没加载。
- 打开一个
.sh文件，点击右下角语言标识（常显示为Plain Text），选Shell Script或Bash - 若仍无提示，按
Ctrl+Shift+P输入ShellCheck: Run ShellCheck，看是否报错command 'shellcheck.run' not found——这是插件未启动的明确信号 - 重启 VSCode 是最简单的兜底操作，尤其 Windows 和旧版 macOS 上常见不重启不加载
找不到 shellcheck 命令？PATH 和 executablePath 得分开看
插件只是“遥控器”，真正干活的是你系统里那个 shellcheck 可执行文件。终端能跑 ≠ VSCode 能调用。
- 终端运行
which shellcheck（macOS/Linux）或where shellcheck（Windows CMD），确认路径存在且版本 ≥ 0.9.0 - 若没安装：macOS 用
brew install shellcheck，Ubuntu 用sudo apt install shellcheck，Windows 推荐choco install shellcheck - VSCode 的
shellcheck.executablePath设置必须填完整路径，例如/opt/homebrew/bin/shellcheck；不能只写shellcheck，否则在 WSL/Conda/nvm 环境下大概率失效
提示一堆“变量未定义”或“[[ 语法错误”？shell 类型没对上
ShellCheck 默认按 POSIX sh 解析，但你的脚本十有八九是 Bash 写的。类型错位，警告就全是干扰项。
- 脚本第一行必须写明 shebang，如
#!/usr/bin/env bash，ShellCheck 会据此切换检查模式 - 若 shebang 缺失或模糊（比如只写
#!/bin/sh），在设置中强制指定shellcheck.shell为bash - 某些警告（如
SC2086、SC2154）属于风格建议，可加shellcheck.additionalArgs配置["-e", "SC2086"]屏蔽，但别全关——漏掉SC2162（read未加-r）这种真坑容易出事
改完配置还是不提示？检查文件关联和保存触发逻辑
VSCode 不靠后缀猜语言，也不默认保存就检查。两个细节最容易被跳过。
- 在
settings.json中加"files.associations": {"*.sh": "shellscript"}，否则新建文件或无后缀脚本永远是Plain Text - 确认
shellcheck.enable为true，且shellcheck.runOnSave也设为true；否则只能手动按Ctrl+Shift+P触发 - 如果用 Remote - WSL 打开文件，别在 Windows 版 VSCode 里硬配本地路径——直接用 WSL 内的 VSCode Server，路径、编码、换行符才一致
最常被忽略的是 shebang 和 shellcheck.shell 的协同关系：哪怕你写了 #!/usr/bin/env bash，如果插件配置里 shellcheck.shell 锁死成 sh，它照样按 POSIX 检——不是工具不灵，是它被你“教错了”。
