ShellCheck

koalaman/shellcheckAI 已审核

用途

ShellCheck 在不运行 bash 或 sh 脚本的情况下读取它，并列出发现的问题：忘记加引号、永远为真的比较、用错的命令、在 bash 里能用但在 sh 里不行的写法。每条警告都有一个编号，在项目的 wiki 上有详细说明。你可以把脚本粘贴到 shellcheck.net，在终端里运行 `shellcheck yourscript`，在 VS Code、Vim 或 Emacs 等编辑器里直接看到警告，或者把它加入自动化构建流程。它免费，采用 GPL-3.0 许可，从 2012 年就存在了。

安装难易度

A · 下载即用 · Web

Windows C
macOS C
Linux C
Web A

网页版不用安装任何东西："Paste a shell script on https://www.shellcheck.net for instant feedback"，README 称这是最简单的试用方式。在电脑上则停留在 C 级，因为它是没有自己窗口的终端程序：一条命令就能安装（Windows 上 `winget install --id koalaman.shellcheck`，macOS 上 `brew install shellcheck`，Linux 上 `sudo apt install shellcheck`），然后你输入 `shellcheck yourscript` 或把它接入编辑器。

GitHub 数据

星标: 40,2662026年10月31日
下载量: 65,477,150本周 1,157,316
增长: +225 天内新增星标

星标变化

事实

可运行于: Web, Windows, macOS, Linux
需要安装: 只需程序本身
磁盘空间: 未确定
账号或密钥: 无
费用: 免费 · 免费，采用 GPL-3.0 许可；贡献的代码也必须是 GPLv3。网站和所有软件包都不收费。
许可证: GPL-3.0 (Copyleft)
最近更新: 2026年10月26日

风险信号 (4)

注意网页版会把你的脚本发送到别人的服务器
README："Paste a shell script on https://www.shellcheck.net for instant feedback"，该网站 "is always synchronized to the latest git commit"。脚本里的任何内容——服务器名称、路径、密钥——都会离开你的电脑。本地安装不需要联网。
AI 审核
信息新版本可能会破坏自动化构建
README："It's a good idea to manually install a specific ShellCheck version regardless. This avoids any surprise build breaks when a new version with new warnings is published." 如果你让构建在出现警告时失败，就应该固定版本。
AI 审核
信息最新发布版来自 2025 年，而代码仍在持续更新
最新发布版 v0.11.0 来自 2025-08-04，但最后一次提交是在 2026-10-26，有 1089 个未关闭的 issue，对应 40262 个星标。14 年里只发布了 30 个版本：项目还活着，但发布得很少，所以包管理器给你的版本可能大幅落后于代码。
AI 审核
信息在 windows 上需要额外折腾
README：在原生 Windows 上 "the system may use a legacy codepage"，所以你得选一个 TrueType 字体并运行 `chcp 65001`，还要在 PowerShell ISE 里加一行额外的编码设置，否则输出会乱码。
AI 审核

证据以原始语言显示。

Radar 无法验证的内容

它是否能找到你脚本里具体的那个错误：它只读文本，从不运行脚本
它的哪些警告在你的脚本里其实无关紧要，这只有你自己能判断
shellcheck.net 是否会保存或记录人们粘贴上去的脚本
你的包管理器给你的是哪个版本，可能比 v0.11.0 旧
磁盘占用情况，自动检查无法确定，不过下载包大小在 2 到 14 MB 之间