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、点击该标识，弹出语言选择菜单。
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
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。
