用 ShellCheck 给 Shell 脚本做体检

举报
yd_273709801 发表于 2026/11/16 10:37:22 2026/11/16
【摘要】 为什么需要它Shell 脚本写起来快,但隐藏的坑也多:变量没加引号、遇到带空格的文件名就出错,cd 失败后命令却继续执行,[ 和 [[ 混着用……这些问题平时不容易发现,往往要到生产环境才暴露出来。ShellCheck 是一个开源的 Shell 脚本静态分析工具,能在运行之前把这些隐患指出来。 安装与使用常见的 Linux 发行版和 macOS 都能直接装,比如 apt install s...

为什么需要它

Shell 脚本写起来快,但隐藏的坑也多:变量没加引号、遇到带空格的文件名就出错,cd 失败后命令却继续执行,[ 和 [[ 混着用……这些问题平时不容易发现,往往要到生产环境才暴露出来。ShellCheck 是一个开源的 Shell 脚本静态分析工具,能在运行之前把这些隐患指出来。

安装与使用

常见的 Linux 发行版和 macOS 都能直接装,比如 apt install shellcheck 或 brew install shellcheck。用法很简单:

shellcheck deploy.sh

每条提示都有一个编号(比如 SC2086),并标出具体的行和列。按编号在官方 Wiki 上能查到详细解释和推荐的写法。

常见提示举例

  • SC2086:变量没加双引号,可能被拆成多个词或被当作通配符展开,建议写成 "$var"。
  • SC2164:cd 后面没有处理失败的情况,建议写成 cd dir || exit。

融入日常流程

  • 在编辑器里装上 ShellCheck 插件,边写边看提示;
  • 在 CI 里对所有 .sh 文件运行 ShellCheck,不通过就不合并;
  • 确实需要忽略某条提示时,用 # shellcheck disable=SCxxxx 只对那一行关闭,并写清楚原因。

小结

ShellCheck 几乎不用额外的学习成本,却能挡住大量低级错误。养成「写完先 check」的习惯,Shell 脚本会可靠很多。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。