SuperAPI AI 工具集

shellcheck

通用与其它

查看项目

更新于 10-16 01:11

技能介绍

用途:校验 shell 脚本(.sh、bash、sh、dash、ksh)的语法错误、常见缺陷、引号问题与可移植性问题,捕获通常只在运行时才暴露的错误。

主要能力:检查 shellcheck 是否可用,缺失时引导安装;检测项目级 .shellcheckrc,否则回退到默认配置;按语法、引号、安全、可移植性和最佳实践进行校验;报告具体 SC 代码并给出修复建议。

安装检查:shellcheck --version 2>/dev/null。未安装时可用:sudo apt-get install shellcheck(Debian/Ubuntu)、brew install shellcheck(Homebrew)、sudo snap install shellcheck(Snap),或从 GitHub releases 下载二进制。安装失败应停止并报告,不得静默跳过校验。

配置优先级:项目根目录 .shellcheckrc、~/.shellcheckrc、$XDG_CONFIG_HOME/shellcheckrc,最后为默认配置。

用法:校验全部脚本 find . -name '*.sh' -exec shellcheck {} +;指定文件 shellcheck script.sh deploy.sh;指定方言 shellcheck -s bash script.sh;从标准输入 cat script.sh | shellcheck -;按严重级别过滤 shellcheck --severity=warning script.sh。

错误处理:校验失败时报告文件与行号、SC 代码、严重级别、问题说明和具体修复,例如 SC2086 建议加双引号、SC2164 建议 cd /app || exit 1、SC2155 建议声明与赋值分开、SC2012 建议用 find 替代 ls。修复后重新校验。

限制:资料未提供该技能的具体平台支持范围、收费方式或性能数据。