用途:该技能面向 ShellCheck 静态分析的配置与使用,用于为 shell 脚本搭建 lint 基础设施、排查代码问题、理解错误码与告警,并在 CI/CD 与开发流程中强制执行代码质量标准。
主要能力:支持 Bash、sh、dash、ksh 等 POSIX shell,提供 100 多种告警与错误;可通过 .shellcheckrc 或环境变量指定目标 shell、启用可选检查、禁用特定告警;支持默认、gcc、json、quiet 等输出格式;可集成编辑器、pre-commit 钩子、GitHub Actions 与 GitLab CI。
使用方式:安装示例包括 brew install shellcheck、apt-get install shellcheck,或从源码 git clone https://github.com/koalaman/shellcheck.git 后 make build、make install,并用 shellcheck --version 验证。项目根目录可创建 .shellcheckrc 设置 shell=bash、enable=...、disable=...;命令行可用 shellcheck --shell=bash --format=gcc --exclude=SC1091 script.sh。CI 中可遍历 *.sh 文件执行 shellcheck 并在失败时退出。
常见错误码:SC1000-1099 解析错误,SC2000-2099 shell 问题,SC2100-2199 引号问题,SC3000-3999 POSIX 兼容问题。可用 # shellcheck disable=SC2086 抑制单行告警,或 # shellcheck source=./helper.sh 指定来源文件。
适用场景:为脚本设置 lint、分析现有脚本、理解错误码、按项目需求配置规则、抑制误报、迁移脚本以满足质量门禁。
限制:仅适用于 ShellCheck 配置与静态分析相关任务;输出不能替代针对具体环境的验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应先澄清。