SuperAPI AI 工具集

shellcheck-configuration

部署与运维

查看项目

更新于 10-16 00:30

技能介绍

用途:本技能提供配置与使用 ShellCheck 的完整指引,用于对 shell 脚本做静态分析,发现常见问题并统一代码质量。适用于搭建 lint 基础设施、修复脚本问题、理解错误码、配置项目规则、集成到开发流程、抑制误报以及迁移脚本以满足质量门槛。

主要能力:ShellCheck 支持 Bash、sh、dash、ksh 等 POSIX shell,提供 100 多种警告与错误,可配置目标 shell 与标志,并集成编辑器与 CI/CD。

安装:macOS 用 brew install shellcheck;Ubuntu/Debian 用 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、SHELLCHECK_STRICT、SHELLCHECK_CONFIG。

常见错误码:SC1000-1099 解析错误,SC2000-2099 shell 问题,SC2100-2199 引号问题,SC3000-3999 POSIX 兼容问题。

用法示例:shellcheck --shell=bash --exclude=SC1091 --enable=all script.sh;CI 中可用 --format=gcc 或 --format=json,quiet 格式仅在有问题时返回非零。

集成:可写入 pre-commit 钩子、GitHub Actions、GitLab CI,用 find 或 xargs 批量检查,并可用哈希缓存结果。

限制:资料未提供具体版本要求、性能基准或与其他 linter 的对比;部分示例存在排版问题,实际使用时需以官方文档为准。