格式化 Shell 脚本利器,轻松理解复杂代码

系统 Linux
格式化脚本很有必要,可以极大地有助于理解复杂的代码。然而,对于那些经常编写 shell 脚本的人来说,重复检查格式可能会成为一项乏味的任务。本文将向您展示如何使用 shfmt 来简化工作!

什么是shfmt?

shfmt 由 Dustin Krysak 开发,是一个 Shell 格式化程序、解析器和解释器。该项目本身托管在 GitHub 上,并有一个清晰的 README 和清晰的存储库。该工具是用 Go 开发的,支持 POSIX、Bash 和 mksh shell。这使得 shfmt 成为一个真正通用的程序,而不是仅限于 Bash。

安装shfmt

要在支持 snap 的 Linux 发行版(如 Ubuntu 和 Mint)上安装shfmt,请在终端中执行以下命令:

linuxmi@linuxmi:~/www.linuxmi.com$ sudo snap install shfmt

要在基于 RedHat/Yum 的 Linux 发行版(如 RHEL、Centos 和 Fedora)上安装shfmt,请在终端中执行以下命令:

注意:在执行第一个命令后和执行下一个命令之前,您必须重新启动计算机(或注销并重新登录)。

sudo dnf install snapd
sudo snap install snap-store
sudo snap install shfmt

在 RHEL 和 Centos 上,您可能还必须先安装EPEL 存储库。

使用 shfmt

安装 snap 包后,您可以开始使用 shfmt。

linuxmi@linuxmi:~/www.linuxmi.com$ shfmt --help

让我们先定义一个非常糟糕的格式和编写的脚本,linuxmi.com.sh如下图所示。

这个脚本有几个问题,最突出的是它的格式。但是脚本中也有一个error/bug:func最后一行的函数调用后面跟着括号。Bash 中的函数调用(而不是函数定义)应该只有名称,而不是括号。

让我们看看shfmt对此有何看法。

linuxmi@linuxmi:~/www.linuxmi.com$ shfmt linuxmi.sh

虽然输出看起来有点晦涩,但请注意术语foo(此处使用)和bar(现在此处未使用)经常在 IT 圈子中用于indicate/represent 任何类似的习语或元素。foo这里真的是指func。

即便如此,该消息仍然有点晦涩,最后一行,真正发生的是函数定义(而不是函数调用)的开始,因为包含了两个括号。这就解释了为什么该消息告诉我们需要更多的东西;后面必须有一个声明。shmft在这里寻找类似func(){ some_command[s]; }的东西。

答对了!这增加了shfmt作为 shell 脚本验证/检查器工具的功能,非常方便!

我们修复了我们刚才的错误,现在输入脚本linuxmi.sh如下图所示。

我们再次对代码执行shfmt并收到更合适且格式正确的输出:

太好了。现在,我们可以更进一步,并告诉shfmt我们希望使用两个空格的缩进/制表符宽度而不是完整的制表符。我总是使用两个空格作为缩进/制表符宽度来编写代码,并在下一行的命令与前一行密切相关的地方使用额外的空格,比如一个连续的命令等等,尽管这种情况并不经常发生。多年来,我发现这两个空间是个人和共享项目的理想选择。

每个人和每个项目都必须找到自己理想的语法,但请注意,如果您使用像shfmt上面示例中呈现的格式那样的大制表符(8 个空格),您的代码可能会变得更难阅读。

我们将使用-i选项将缩进/制表符宽度设置为两个空格(--help定义为缩进:0 表示制表符(默认),>0 表示空格数):shfmt -i 2 linuxmi.sh这将上图中的脚本呈现如下图。

太棒了!然而,我们注意到,我们故意犯的错误shfmt并没有检测到:#!/bin/bash__是不正确,应该使用#!/bin/bash代替。

因此,除了使用shfmt更好地格式化脚本之外,还有使用shellcheck来查找脚本错误的用例。(见:https://www.linuxmi.com/shellcheck-bugs-linux-shell.html)。然而,有趣的是,在这种特殊情况下,甚至shellcheck没有注意到这个问题。这个缺陷已报告给 shellcheck 团队,因此可能会在适当的时候得到修复。

总结

当您使用像shfmt这样的shell 格式化工具(如shellcheck)这样的bug/错误检查器时,编写干净、格式良好、没有bug的脚本就变得很容易了。正如我们所看到的,有些事情可能直到第一次运行脚本时才被注意到。shfmt是一个小而有效的工具,它将帮助您根据您选择的缩进格式化您的脚本和代码。

好好享受吧。

责任编辑:庞桂玉 来源: Linux公社
相关推荐

2015-08-10 14:42:40

Explain SheShell 命令

2012-05-16 09:14:11

代码美化代码工具Java

2015-01-07 15:21:30

Android Stu代码格式化

2010-07-29 11:03:53

Flex代码格式化

2023-12-05 18:04:58

PyCharmPython

2009-02-26 16:56:07

虚拟化ITVMware

2012-04-26 14:02:58

ibmdw

2010-08-03 10:46:41

Flex代码格式化

2022-03-10 10:24:45

Vim代码Linux

2009-09-04 13:19:59

C#代码格式化

2020-11-03 10:21:33

MySQL

2014-08-20 10:13:33

虚拟化

2010-08-02 16:25:03

ibmdwJDT

2010-07-08 16:21:46

Sql Server

2023-11-01 13:37:38

Golang代码

2009-08-03 14:25:59

C#日期格式化

2024-01-08 22:03:22

python代码开发

2022-05-09 08:17:37

InstantJava字符

2024-04-11 13:51:47

markdown前端

2012-03-22 09:15:29

开发代码
点赞
收藏

51CTO技术栈公众号