服务器的开发和管理离不开 Bash 脚本,掌握它需要学习大量的细节。
set
命令是 Bash 脚本的重要环节,却常常被忽视,导致脚本的安全性和可维护性出问题。本文介绍它的基本用法,让你可以更安心地使用 Bash 脚本。
一、简介
我们知道,Bash 执行脚本的时候,会创建一个新的 Shell。
$ bash script.sh
上面代码中,script.sh
是在一个新的 Shell 里面执行。这个 Shell 就是脚本的执行环境,Bash 默认给定了这个环境的各种参数。
set
命令用来修改 Shell 环境的运行参数,也就是可以定制环境。一共有十几个参数可以定制,官方手册有完整清单,本文介绍其中最常用的四个。
顺便提一下,如果命令行下不带任何参数,直接运行set
,会显示所有的环境变量和 Shell 函数。
$ set
二、set -u
执行脚本的时候,如果遇到不存在的变量,Bash 默认忽略它。
#!/usr/bin/env bash echo $a echo bar
上面代码中,$a
是一个不存在的变量。执行结果如下。
$ bash script.sh bar
可以看到,echo $a
输出了一个空行,Bash 忽略了不存在的$a
,然后继续执行echo bar
。大多数情况下,这不是开发者想要的行为,遇到变量不存在,脚本应该报错,而不是一声不响地往下执行。
set -u
就用来改变这种行为。脚本在头部加上它,遇到不存在的变量就会报错,并停止执行。
#!/usr/bin/env bash set -u echo $a echo bar
运行结果如下。
$ bash script.sh bash: script.sh:行4: a: 未绑定的变量
可以看到,脚本报错了,并且不再执行后面的语句。
-u
还有另一种写法-o nounset
,两者是等价的。
set -o nounset
三、set -x
默认情况下,脚本执行后,屏幕只显示运行结果,没有其他内容。如果多个命令连续执行,它们的运行结果就会连续输出。有时会分不清,某一段内容是什么命令产生的。
set -x
用来在运行结果之前,先输出执行的那一行命令。
#!/usr/bin/env bash set -x echo bar
执行上面的脚本,结果如下。
$ bash script.sh + echo bar bar
可以看到,执行echo bar
之前,该命令会先打印出来,行首以+
表示。这对于调试复杂的脚本是很有用的。
-x
还有另一种写法-o xtrace
。
set -o xtrace
四、Bash 的错误处理
如果脚本里面有运行失败的命令(返回值非0),Bash 默认会继续执行后面的命令。
#!/usr/bin/env bash foo echo bar
上面脚本中,foo
是一个不存在的命令,执行时会报错。但是,Bash 会忽略这个错误,继续往下执行。
$ bash script.sh script.sh:行3: foo: 未找到命令 bar
可以看到,Bash 只是显示有错误,并没有终止执行。
这种行为很不利于脚本安全和除错。实际开发中,如果某个命令失败,往往需要脚本停止执行,防止错误累积。这时,一般采用下面的写法。
command || exit 1
上面的写法表示只要command
有非零返回值,脚本就会停止执行。
如果停止执行之前需要完成多个操作,就要采用下面三种写法。
# 写法一 command || { echo "command failed"; exit 1; } # 写法二 if ! command; then echo "command failed"; exit 1; fi # 写法三 command if [ "$?" -ne 0 ]; then echo "command failed"; exit 1; fi
另外,除了停止执行,还有一种情况。如果两个命令有继承关系,只有第一个命令成功了,才能继续执行第二个命令,那么就要采用下面的写法。
command1 && command2
五、 set -e
上面这些写法多少有些麻烦,容易疏忽。set -e
从根本上解决了这个问题,它使得脚本只要发生错误,就终止执行。
#!/usr/bin/env bash set -e foo echo bar
执行结果如下。
$ bash script.sh script.sh:行4: foo: 未找到命令
可以看到,第4行执行失败以后,脚本就终止执行了。
set -e
根据返回值来判断,一个命令是否运行失败。但是,某些命令的非零返回值可能不表示失败,或者开发者希望在命令失败的情况下,脚本继续执行下去。这时可以暂时关闭set -e
,该命令执行结束后,再重新打开set -e
。
set +e command1 command2 set -e
上面代码中,set +e
表示关闭-e
选项,set -e
表示重新打开-e
选项。
还有一种方法是使用command || true
,使得该命令即使执行失败,脚本也不会终止执行。
#!/bin/bash set -e foo || true echo bar
上面代码中,true
使得这一行语句总是会执行成功,后面的echo bar
会执行。
-e
还有另一种写法-o errexit
。
set -o errexit
六、set -o pipefail
set -e
有一个例外情况,就是不适用于管道命令。
所谓管道命令,就是多个子命令通过管道运算符(|
)组合成为一个大的命令。Bash 会把最后一个子命令的返回值,作为整个命令的返回值。也就是说,只要最后一个子命令不失败,管道命令总是会执行成功,因此它后面命令依然会执行,set -e
就失效了。
请看下面这个例子。
#!/usr/bin/env bash set -e foo | echo a echo bar
执行结果如下。
$ bash script.sh a script.sh:行4: foo: 未找到命令 bar
上面代码中,foo
是一个不存在的命令,但是foo | echo a
这个管道命令会执行成功,导致后面的echo bar
会继续执行。
set -o pipefail
用来解决这种情况,只要一个子命令失败,整个管道命令就失败,脚本就会终止执行。
#!/usr/bin/env bash set -eo pipefail foo | echo a echo bar
运行后,结果如下。
$ bash script.sh a script.sh:行4: foo: 未找到命令
可以看到,echo bar
没有执行。
七、总结
set
命令的上面这四个参数,一般都放在一起使用。
# 写法一 set -euxo pipefail # 写法二 set -eux set -o pipefail
这两种写法建议放在所有 Bash 脚本的头部。
另一种办法是在执行 Bash 脚本的时候,从命令行传入这些参数。
$ bash -euxo pipefail script.sh
八、参考链接
(完)
wubing 说:
请问是不是因为要发广告而写了?
2017年11月15日 09:52 | # | 引用
Mike 说:
支持阮老师,多多出文!
2017年11月15日 10:19 | # | 引用
知道91 说:
阮老师这篇文章的广告较少~~~O(∩_∩)O哈哈~
2017年11月15日 12:13 | # | 引用
SA 说:
挺好的 这些小细节如果正儿八经要从什么书里面专门去学的话 一个是找起来效率太低 有时候你甚至根本不知道应该搜索什么
2017年11月15日 14:35 | # | 引用
Juu 说:
满心期待出新,但怎么感觉广告味渐渐变浓了呢?只有我这么觉得吗?
2017年11月15日 15:21 | # | 引用
泉心依旧 说:
阮老师,经常看你的文章,惊叹于你对技术和未来的深刻思考与见解。在此想请教你对一个问题的看法,希望你能对此话题感兴趣,如果能写成博文分享你的看法那就更好了。由于近些年关于量子通信和量子计算机各项技术的突破经常见诸科技新闻,我产生了自己的一些思考:在未来,量子计算机是否会颠覆经典计算机,量子通信的保密性是否会使密码学大厦轰然倒塌......。量子技术的发展必然会对人类社会产生影响,但到底会影响哪些方面,影响的程度又如何,是否会完全改写某一领域,对此想听听阮老师的见解,还望不吝赐教。
2017年11月15日 16:13 | # | 引用
马猴 说:
登个广告,就有人不乐意了?!
做人别太自私,各取所需就行。
峰哥的东西还是不错的。
2017年11月15日 16:18 | # | 引用
夏恺 说:
1. 个人不建议用-e/-u这样的写法,不容易读,写成
会好些
2. 很多编辑器支持对于特定后缀的文件在创建时添加指定字符串作为模版,对于vim, 示例如下:
2017年11月16日 06:38 | # | 引用
wells 说:
为了发而发~
2017年11月17日 10:06 | # | 引用
lion 说:
@夏恺:
请问第二个能具体说说在哪么,我怎么找到的网上都是templates里添加
2017年11月17日 15:32 | # | 引用
吴志新 说:
能够数十年如一日的进行这些科普,阮老师的这种精神值得学习。
2017年11月19日 18:28 | # | 引用
Kios 说:
You should try Python, it's more powerful than bash.
2017年11月20日 15:06 | # | 引用
custa 说:
-x 结合 PS4 环境变量设置,能够比较清晰地调试
2017年11月24日 15:46 | # | 引用
jellyabd 说:
感谢!!!
2017年11月27日 10:11 | # | 引用
smart 说:
建议可以用alias命令改写bash,这样就不用每次都要添加选项了
2017年11月28日 13:34 | # | 引用
ixx 说:
很实用的小知识,收藏了,虽然写脚本的时候不多
2017年11月28日 19:02 | # | 引用
WoodWang 说:
shell的三种执行方式,./script.sh和sh script.sh方式下遇到不存在的变量,脚本不会继续往下执行了;但是第三种source script.sh方式下还会继续执行后面的脚本操作。
2017年11月29日 10:10 | # | 引用
王辉 说:
脚本就没有系统的学过,每次用都是查stackoverflow,东凑西拼的,请问谁有比较系统的书推荐吗?
2017年12月 4日 04:31 | # | 引用
flygoxc 说:
一直都只会设置classpath或者PATH,没有想到还有这招啊....
2017年12月 6日 23:41 | # | 引用
纵横 说:
最近刚刚开始学习linux, 谢谢老师!
2017年12月22日 02:47 | # | 引用
葫芦侠 说:
很久不用忘记了,一搜就看到这篇文章。阮老师的文章一如既往的简明清晰,文章排版,内容不错!
2018年1月 8日 17:55 | # | 引用
Janvn 说:
阮老师的文章几乎偏偏通俗易懂,言简意赅,赞!!!
2018年2月 9日 09:38 | # | 引用
delusionxb 说:
可以用 'failedCmd || :' 的写法在任何情况下都返回 true, 也就是返回 0
2019年6月17日 17:07 | # | 引用
Xanthuim 说:
set -m这么重要居然没讲。。
2019年7月22日 14:35 | # | 引用
Yao Frankie 说:
个人认为写博客有两个境界,一种是写给自己看的,另一种是写给别人看的。
我还是要继续向阮老师学习。
最后补下四种参数的全称:
-u: Treat unset variables as an error when substituting.
-x: Print commands and their arguments as they are executed.
-e: Exit immediately if a command exits with a non-zero status.
-o: option-name.
2019年12月 9日 17:07 | # | 引用
linuxops 说:
当我在脚本中加入 set -uxeo pipefail
yzstate=$(tail -800 /root/logs/2021-04-13.1.log |grep -c 'ai ret')
这个变量的值为零时下面的命令就不会运行, 这个想不通诶,求大佬指点
2021年4月16日 11:27 | # | 引用
西瓜太郞 说:
因为grep未匹配到内容时,返回的是1,非0,因为有e的原因就停下来了。
2021年10月20日 09:59 | # | 引用