Microsoft Azure OpenDev—June 2017
目录:
在编写Bash脚本时,始终使代码干净且易于理解是一个好习惯。 以块形式组织代码,缩进,为变量和函数提供描述性名称是实现此目的的几种方法。
提高代码可读性的另一种方法是使用注释。 注释是在shell脚本中编写的易于理解的解释或注释。
在将来查看代码时,将注释添加到Bash脚本将节省大量时间和精力。 假设您要更改几个月或几年前编写的脚本。 除非您添加注释,否则您将不记得为什么编写了一些复杂的代码。
这些注释还可以帮助可能需要维护脚本以了解您的代码及其用途的其他开发人员和系统管理员。
注释通常用于解释代码不能执行的操作。 例如,如果您的Bash脚本中有复杂的正则表达式或参数替换,则应编写有关代码功能的注释。 评论应该简短明了。 不要解释一些简单易懂的内容。
,我们将介绍在Bash中编写评论的基础。
在Bash中撰写评论
Bash忽略该行上井号(
#
)之后写入的所有内容。 该规则的唯一例外是脚本的第一行以
#!
开头
#!
字符。 此字符序列称为Shebang,用于告诉操作系统使用哪个解释器来解析文件的其余部分。
注释可以添加到行的开头或与其他代码内联:
# This is a Bash comment. echo "This is Code" # This is an inline Bash comment.
井号后面的空格不是强制性的,但是它将提高注释的可读性。
通常,在文本编辑器中打开脚本时,注释以绿色表示。
测试脚本时,注释也很有用。 除了删除一些行或块,您还可以将它们注释掉:
# if]; then # echo "Variable is greater than 10." # fi
Bash中的多行注释
与大多数编程语言不同,Bash不支持多行注释。
在Bash中编写多行注释的最简单方法是一个接一个地添加单个注释:
# This is the first line. # This is the second line.
另一种选择是使用HereDoc。 这是一种重定向类型,它允许您将多行输入传递给命令。 如果HereDoc块未重定向到命令,则可以用作多行注释占位符:
<< 'MULTILINE-COMMENT' Everything inside the HereDoc body is a multiline comment MULTILINE-COMMENT
使用HereDoc是一种技巧,而不是真正的内置方式来编写多行Bash注释。 为了避免出现任何问题,您应该首选使用单行注释。
结论
编写注释是一种好习惯,并且可以帮助其他开发人员(包括将来的自己)理解Shell脚本。 在Bash中,井号(
#
)之后直到行尾的所有内容都被视为注释。
如果您有任何问题或反馈,请随时发表评论。
bash终端






