ShellCheck 插件可解决 VSCode 中 Shell 脚本缺乏静态分析的问题，需依次安装插件、本地 shellcheck 工具、配置文件类型识别、启用实时诊断，并支持自定义检查规则。
如果您在 VSCode 中编写 Shell 脚本，但无法及时发现语法错误、未定义变量或不安全的命令构造，则可能是缺少对脚本的静态分析支持。ShellCheck 插件可自动识别常见 Shell 陷阱并提供修复建议。以下是启用与使用该插件的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 ShellCheck 插件
ShellCheck 插件需通过 VSCode 扩展市场安装，其依赖本地 ShellCheck 二进制程序进行实际分析。安装插件本身不包含分析引擎，仅提供语言支持与结果展示界面。
1、打开 VSCode，点击左侧活动栏中的扩展图标（四个方块组成的图标）。
2、在搜索框中输入 ShellCheck，找到作者为TimonVS 的官方插件。
3、点击“安装”按钮，等待安装完成。
二、安装本地 ShellCheck 命令行 工具
插件必须调用系统级 ShellCheck 可执行文件才能运行分析。若未安装，插件将提示“ShellCheck not found”，且所有检查功能失效。
1、打开终端，执行命令：brew install shellcheck（适用于已安装 Homebrew 的 macOS 用户）。
2、验证安装是否成功：在终端中运行 shellcheck –version，应输出类似ShellCheck – version 0.10.0 的信息。
3、若使用 Linux 系统，请改用对应包管理器，例如 Ubuntu 下执行：sudo apt-get install shellcheck。
三、配置 VSCode 以识别 Shell 文件类型
VSCode 需正确识别。sh 文件为 Shell 语言，否则插件不会激活语法检查。默认情况下部分脚本可能被识别为 Plain Text 或其他语言类型。
1、打开一个。sh 文件，在编辑器右下角查看当前语言标识（如显示“Plain Text”）。
2、点击该标识，弹出语言选择菜单。
3、在搜索框中输入 shellscript，选择Shell Script 选项。
4、为永久生效，可在设置中搜索files.associations，添加条目：“*.sh”: “shellscript”。
四、启用实时诊断与手动触发检查
ShellCheck 插件默认开启保存时自动检查，也可手动触发以即时查看问题。诊断结果以波浪线形式标出，并在悬停时显示详细说明与修复建议。
1、在打开的。sh 文件中，输入存在风险的代码，例如：echo $USER_NAME（变量未定义）。
2、保存文件后，变量名下方将出现红色波浪线。
3、将鼠标悬停于波浪线上，查看提示信息，如SC2154: USER_NAME is referenced but not assigned.。
4、按快捷键Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入并选择ShellCheck: Run ShellCheck。
五、自定义 ShellCheck 检查级别与规则
ShellCheck 默认启用全部警告级别（warning、info、error），但可通过配置禁用特定规则或调整敏感度，避免干扰开发节奏。
1、在 VSCode 设置中搜索shellcheck.enable，确认其值为 true。
2、搜索shellcheck.stdin，将其设为 true 以支持管道输入检查。
3、在工作区根目录创建 .shellcheckrc 文件，写入需忽略的规则，例如：disable=SC2086,SC2034。
4、在 VSCode 设置中指定该配置路径：搜索shellcheck.configFile，填入./.shellcheckrc。
