如何在 Shell 脚本中执行语法检查调试模式

我们通过解释不同的调试选项以及如何启用 shell 脚本调试模式开始了 shell 脚本调试系列。

编写 shell 脚本后，建议我们在运行脚本之前实际检查脚本中的语法，而不是查看其输出来确认它们是否正常工作。

在本系列的这一部分中，我们将介绍如何使用语法检查调试模式。记住，我们在本系列的第一部分中解释了不同的调试选项，在这里，我们将使用它们进行脚本调试。

启用详细调试模式

在进入本指南的重点之前，让我们简要地了解一下详细模式。它由调试选项启用-v，该选项告诉 shell 在读取脚本时显示所有行。

为了演示其工作原理，下面是一个示例 shell 脚本，用于将PNG 图像批量转换为 JPG 格式。

将其输入（或复制并粘贴）到文件中。

#!/bin/bash
#convert
for image in *.png; do
        convert  "$image"  "${image%.png}.jpg"
        echo "image $image converted to ${image%.png}.jpg"
done
exit 0

然后保存文件并使用以下命令使脚本可执行：

$ chmod +x script.sh

我们可以调用该脚本并显示其中的所有行，就像 shell 读取它们一样：

$ bash -v script.sh

在 Shell 脚本中启用语法检查调试模式

回到我们重点的话题，-n激活语法检查模式。它指示 shell 基本上读取所有命令，但不执行它们，它 (shell) 仅检查使用的语法。

如果你的 shell 脚本有错误，shell 会在终端上输出错误，否则就不会显示任何内容。

激活语法检查的语法如下：

$ bash -n script.sh

因为脚本中的语法是正确的，所以上面的命令不会显示任何输出。因此，让我们尝试删除done关闭 for 循环的单词，看看它是否显示错误：

下面是修改后的将 png 图像批量转换为 jpg 格式的 shell 脚本，其中包含一个错误。

#!/bin/bash
#script with a bug
#convert
for image in *.png; do
        convert  "$image"  "${image%.png}.jpg"
        echo "image $image converted to ${image%.png}.jpg"

exit 0

保存文件，然后在执行语法检查时运行它：

$ bash -n script.sh

从上面的输出中，我们可以看到我们的脚本存在语法问题，for 循环缺少结束done关键字。并且 shell 查找它直到文件末尾，一旦找不到它（done），shell 就会打印语法错误：

script.sh: line 11: syntax error: unexpected end of file

我们也可以将详细模式和语法检查模式结合在一起：

$ bash -vn script.sh

或者，我们可以通过修改上面脚本的第一行来启用语法检查，如下一个示例所示。

#!/bin/bash -n
#altering the first line of a script to enable syntax checking

#convert
for image in *.png; do
    convert  "$image"  "${image%.png}.jpg"
    echo "image $image converted to ${image%.png}.jpg"

exit 0

与前面一样，保存文件并在执行语法检查时运行它：

$ ./script.sh

script.sh: line 12: syntax error: unexpected end of file

另外，我们可以在上面的脚本中使用set shell内置命令来启用调试模式。

在下面的例子中，我们仅检查脚本中 for 循环的语法。

#!/bin/bash
#using set shell built-in command to enable debugging
#convert

#enable debugging
set -n
for image in *.png; do
    convert  "$image"  "${image%.png}.jpg"
    echo "image $image converted to ${image%.png}.jpg"

#disable debugging
set +n
exit 0

再次保存文件并调用脚本：

$ ./script.sh 

总之，我们应该始终确保在执行 shell 脚本之前对其进行语法检查，以捕获任何错误。

如果要向我们发送有关本指南的任何问题或反馈，请使用下面的回复表。在本系列的第三部分中，我们将解释和使用 shell 跟踪调试模式。