用途:本技能提供配置与使用 ShellCheck 进行 Shell 脚本静态分析的指导,帮助发现常见陷阱、提升脚本质量并执行最佳实践。
主要能力:涵盖在 CI/CD 流水线中为 Shell 脚本搭建检查、分析已有脚本问题、理解 ShellCheck 错误码与警告、按项目需求配置 ShellCheck、抑制误报与配置规则集、执行一致的代码质量标准,以及迁移脚本以满足质量门槛。更详细的模式与示例记录在 references/details.md,当上层导航信息不足时可查阅该文件。
最佳实践:在 CI/CD 中运行 ShellCheck,在合并前捕获问题;针对目标 Shell 配置,不要用 sh 的规则分析 bash;记录排除项,说明为何抑制告警;处理违规而不是仅仅禁用警告;启用严格模式,使用 --enable=all 并谨慎设置排除项;定期更新 ShellCheck 以获得新检查;使用 pre-commit 钩子在推送前本地捕获问题;与编辑器集成,在开发中获得实时反馈。
适用场景:搭建 linting 基础设施、修复代码问题、确保脚本质量、配置项目特定规则、集成到开发工作流。
限制:资料未提供具体安装命令、版本要求、各错误码的详细解释或完整配置示例,相关内容暂未提供;实际使用时需结合官方文档与项目环境确认。