ShellCheck需先安装VSCode扩展及本地CLI工具，配置可执行路径、文件类型关联，并调整检查级别与Shell类型。 macOS用户用brew install shellcheck，路径设为/opt/homebrew/bin/shellcheck，关联.bash等后缀为shellscript。
如果您在vscode中编写shell脚本，但未对语法、潜在错误或可移植性问题进行即时检测，则可能是由于shellcheck扩展未正确配置或未启用。以下是启用并有效使用shellcheck进行静态分析的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装ShellCheck扩展
ShellCheck需要通过VSCode的扩展市场安装官方插件，以提供语法高亮、实时诊断和快速修复建议。该扩展依赖本地ShellCheck可执行文件完成分析，因此需先确保编辑器识别到该工具。
1、打开VSCode，点击左侧活动栏中的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入ShellCheck，找到作者为timonwong的官方扩展。
3、点击“安装”按钮，等待安装完成。
二、安装ShellCheck命令行工具
VSCode的ShellCheck扩展本身不附带分析引擎，必须在系统中安装ShellCheck CLI，否则扩展将无法执行任何检查。扩展通过调用shellcheck命令读取脚本并返回诊断结果。
1、打开终端，执行命令：brew install shellcheck（适用于macOS Homebrew用户）。
2、若使用Linux系统，运行：sudo apt-get install shellcheck（Debian/Ubuntu）或sudo dnf install ShellCheck（Fedora）。
3、验证安装是否成功：在终端中输入shellcheck --version，确认输出版本号不低于0.9.0。
三、配置VSCode识别ShellCheck路径
当ShellCheck CLI未被自动发现时（例如安装在非标准路径），需手动指定其可执行文件位置，否则VSCode将显示“ShellCheck not found”警告且不触发分析。
1、按下Cmd+,（macOS）打开设置界面。
2、在搜索框中输入shellcheck.executablePath。
3、点击“在settings.json中编辑”，在JSON对象内添加键值对："shellcheck.executablePath": "/opt/homebrew/bin/shellcheck"（路径需替换为which shellcheck实际输出结果）。
四、启用ShellCheck对特定文件类型的支持
默认情况下，ShellCheck仅对.sh文件启用分析。若脚本使用其他扩展名（如.bash、.zsh或无扩展名），需显式声明语言模式与ShellCheck关联，否则不会触发静态检查。
1、打开任意目标脚本文件，点击右下角当前语言标识（如“Plain Text”）。
2、在弹出菜单中选择Configure File Association for '.xxx'（xxx为实际扩展名）。
3、在输入框中键入shellscript并回车，使VSCode将该后缀识别为Shell脚本。
五、调整ShellCheck检查级别与规则集
ShellCheck默认启用全部警告级别（info/warning/error），但部分提示可能过于严格或与项目约定冲突。可通过配置禁用特定规则，或切换检查模式以适配不同Shell解释器行为。
1、在settings.json中添加配置项："shellcheck.enable": true确保功能开启。
2、添加规则屏蔽配置："shellcheck.exclude": ["SC2034", "SC2154"]（示例：忽略未使用变量与未声明变量警告）。
3、指定Shell类型以修正误报："shellcheck.shell": "bash"（可选值：bash/zsh/dash/sh）。
