⚡

ShellCheck配置生成器 shellcheck-config-generator

ShellCheck配置生成器是一个用于自动化生成Shell脚本静态代码检查（linting）配置文件的工具。它能根据项目需求，智能配置ShellCheck的检查规则、排除项、Shell方言和严重性级别，提升Shell脚本开发的质量与效率。关键词：Shell脚本，代码检查，静态分析，配置生成，ShellCheck，开发工具，DevOps。

DevOps 0 次安装 0 次浏览 更新于 2/23/2026

名称: shellcheck配置生成器 描述: 为Shell脚本代码检查生成包含适当规则、排除项和严重性设置的.shellcheckrc配置文件。 允许的工具: 读取, 写入, 编辑, Bash, Glob, Grep

ShellCheck 配置生成器

为Shell脚本代码检查生成ShellCheck配置文件。

能力

  • 生成 .shellcheckrc 文件
  • 配置规则排除项
  • 设置Shell方言
  • 配置严重性级别
  • 记录规则决策
  • 创建项目特定的配置

使用方法

当您需要以下操作时，请调用此技能：

  • 为项目设置ShellCheck
  • 配置代码检查规则
  • 排除特定警告
  • 记录规则决策

生成的配置

# .shellcheckrc - ShellCheck 配置文件
# https://www.shellcheck.net/wiki/

# 默认Shell方言 (sh, bash, dash, ksh)
shell=bash

# 源文件的搜索路径
source-path=SCRIPTDIR
source-path=lib/

# 外部源（跟随source命令）
external-sources=true

# 严重性级别: error, warning, info, style
severity=warning

# 禁用特定警告

# SC1090: 无法跟踪非常量源
disable=SC1090

# SC1091: 未跟踪（未找到源文件）
disable=SC1091

# SC2034: 变量似乎未使用（常用于源脚本中）
# disable=SC2034

# SC2086: 使用双引号防止通配符扩展（有时是故意的）
# disable=SC2086

# SC2155: 分别声明和赋值
# disable=SC2155

# 启用可选检查

# 检查可能为空的未加引号变量
enable=check-unassigned-uppercase

# 检查额外的返回值屏蔽
enable=check-extra-masked-returns

规则类别

关键（永不禁用）

  • SC2094: 在同一管道中读写文件
  • SC2095: 添加 < /dev/null 以防止ssh占用标准输入
  • SC2096: 脚本需要shebang
  • SC2148: 缺少shebang

重要（谨慎禁用）

  • SC2086: 使用双引号防止通配符扩展
  • SC2046: 使用引号防止单词拆分
  • SC2035: 使用 ./* 避免通配符问题
  • SC2012: 使用find代替ls

风格（项目决定）

  • SC2034: 变量似乎未使用
  • SC2155: 分别声明和赋值
  • SC2164: 使用 cd … || exit

目标流程

  • shell脚本开发
  • 命令行单元集成测试
  • 跨平台命令行兼容性