SuperAPI AI 工具集

shellcheck-configuration

部署与运维

查看项目

更新于 10-16 08:02

技能介绍

用途:指导配置与使用 ShellCheck 对 shell 脚本做静态分析,发现常见陷阱并统一代码质量标准,适用于搭建 lint 基础设施、修复脚本问题、在 CI/CD 中设置检查、理解错误码、抑制误报以及迁移脚本以满足质量门禁。

主要能力:支持 Bash、sh、dash、ksh 等 POSIX shell,提供 100 多种警告与错误;可通过 .shellcheckrc 或环境变量指定目标 shell、启用可选检查、禁用特定警告;支持默认、gcc、json、quiet 等输出格式,便于 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=SC1091 等。命令行常用 --shell、--exclude、--enable、--format、--external-sources、--check-sourced。可集成到 pre-commit 钩子、GitHub Actions、GitLab CI,例如 find . -type f -name "*.sh" -exec shellcheck {} ;。

常见错误码:SC1000-1099 解析错误,SC2000-2099 shell 问题,SC2100-2199 引号问题,SC3000-3999 POSIX 兼容问题。可用 # shellcheck disable=SC2086 在行或脚本级抑制。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;实际行为取决于所安装版本与目标 shell,需自行验证。