SuperAPI AI 工具集

shellcheck-cicd-2025

办公与效率

查看项目

更新于 10-15 23:41

技能介绍

用途:把 ShellCheck 静态检查作为 bash 脚本开发中不可协商的流程环节,用于在提交或合并前发现脚本缺陷、安全问题和风格不一致。资料将其定位为 2025 年现代 bash 工作流的强制实践,声称被多数 DevOps 团队要求、是企业环境的标准做法。

主要能力:覆盖 ShellCheck 安装(apt-get install shellcheck、brew install shellcheck、apk add shellcheck、choco install shellcheck,或下载二进制)、GitHub Actions 集成(ludeeus/action-shellcheck,severity 与 format 选项、失败时注释 PR)、Azure DevOps 流水线集成、Git 预提交钩子与 pre-commit 框架配置、VS Code 设置(onType 运行、排除规则、自定义参数 -x)、Dockerfile 多阶段构建中校验脚本。

规则与用法:列举若干常见规则的错误与正确写法,如 SC2327/SC2328 捕获组应使用 BASH_REMATCH、SC2294 避免 eval 破坏数组安全、SC2295 在 ${} 内加引号、SC2086 变量加引号、SC2046 引号化命令替换、SC2155 声明与赋值分离、SC2164 使用 cd || exit。同时给出 --severity=warning、--format=gcc/json/tty 等报告生成方式,以及强制失败与仅告警两种 CI 策略。

适用场景:bash 脚本仓库的持续集成、提交前校验、容器镜像构建校验、IDE 实时反馈。限制:资料称 v0.11.0 为 2025 年 8 月最新版本并支持 Bash 5.3、POSIX.1-2024,但未提供官方验证信息;文中关于“必须”“强制”的表述属于该技能的主张,非客观事实。若需实际落地,具体版本、规则编号与支持范围请以 ShellCheck 官方文档为准。