ShellCheck错误提示不出现，需先确认文件语言模式为Shell Script且插件已激活；右下角显示“Plain Text”即未识别，须手动选择或配置"files.associations": {"*.sh": "shellscript"}，并重启VSCode验证。
ShellCheck错误提示不出现？先确认文件语言模式和插件激活状态
VSCode不会自动把 .sh 文件当作 Shell 脚本处理，哪怕你装了插件，右下角显示“Plain Text”或“Bash”以外的类型，shellcheck 就完全不工作。这不是插件故障，是 VSCode 的语言识别没到位。
- 打开任意
.sh文件，看右下角状态栏——必须显示Shell Script（不是Bash、Shell或空） - 点击该标识，手动选
Shell Script；若频繁出错，进设置搜files.associations，加一条："*.sh": "shellscript" - 重启 VSCode 后再试：改一行保存，看有没有波浪线。没反应？说明插件根本没加载，不是配置问题
Ctrl+Shift+P 里哪些 ShellCheck 命令真正有用？
快捷键本身不触发检查，真正起作用的是命令面板里的几个关键动作。别只盯着 ShellCheck: Run ShellCheck，它只是手动跑一次，对日常开发帮助有限。
-
ShellCheck: Run ShellCheck：适合临时验证某段粘贴进来的脚本，但不会持续反馈 -
ShellCheck: Toggle Diagnostics：开关当前文件的实时诊断，调试时快速屏蔽干扰项 -
ShellCheck: Show Output：当提示消失或报错时必用——输出面板里会显示command 'shellcheck.run' not found这类真实错误，比猜更有用 - 配合
editor.codeActionsOnSave设置："source.fixAll.shellcheck"才能在保存时自动修复可修项（如引号补全）
shellcheck.run 配成 onSave 还是 onType？别只看文档说的
onType 看似“实时”，但在复杂脚本里容易误报、卡顿，尤其含大量变量展开或嵌套 $(...) 时；onSave 表面延迟，实际更稳，且能避免边写边被红波浪线打断思路。
-
onType适合短小脚本（SC2086（未引号变量）这类基础问题 -
onSave是生产环境首选：避免因中间态语法（比如只写了一半的if [）触发误报；也兼容 WSL/Remote 场景下路径解析延迟 - 注意：
onSave不等于“只在保存时检查”——它仍会缓存诊断结果，修改后悬停仍能看到旧提示，直到下次保存刷新
shellcheck.executablePath 怎么填才不踩坑？
插件默认走系统 PATH 找 shellcheck，但 macOS 上用 brew、Linux 用 apt、Windows 用 choco 装的路径各不相同，而且 VSCode 启动方式（桌面图标 vs 终端执行）会影响环境变量继承。
- 终端里运行
which shellcheck，复制完整路径，例如/opt/homebrew/bin/shellcheck（macOS）或/usr/bin/shellcheck（Ubuntu） - VSCode 设置里填
shellcheck.executablePath，**不要加引号，不要末尾斜杠**，否则插件直接静默失败 - WSL 用户：Windows 版 VSCode 编辑 WSL 文件时，
shellcheck.executablePath必须指向 Windows 下安装的版本（如C:\ProgramData\chocolatey\bin\shellcheck.exe），否则找不到二进制 - 如果用了
nvm或asdf管 Node，它们可能污染 PATH，这时显式指定路径比依赖环境变量更可靠
最容易被忽略的其实是 shebang 和 shell 类型匹配——#!/bin/sh 的脚本被当成 bash 解析，[[ 就会标红；shellcheck.shell 设成 sh 才对。这个配置不写进设置，光靠插件自动推断经常翻车。
