虾说全栈
虾说全栈

set 命令和 shopt 命令

 小虾米
  约 3600 字 预计阅读 8 分钟  - 次阅读  
警告
本文最后更新于 2023-10-22，文中内容可能已过时。

set 命令和 shopt 命令

set命令是 Bash 脚本的重要环节，却常常被忽视，导致脚本的安全性和可维护性出问题。本章介绍set的基本用法，帮助你写出更安全的 Bash 脚本。

简介

我们知道，Bash 执行脚本时，会创建一个子 Shell。

关于子 Shell，请看《Bash 子 shell》

1

$ bash script.sh

上面代码中，script.sh是在一个子 Shell 里面执行。这个子 Shell 就是脚本的执行环境，Bash 默认给定了这个环境的各种参数。

set命令用来修改（子）Shell 环境的运行参数，即定制环境。一共有十几个参数可以定制，官方手册有完整清单，本章介绍其中最常用的几个。

顺便提一下，如果命令行下不带任何参数，直接运行set，会显示所有的环境变量和 Shell 函数。

关于 set 命令，我们在《Bash 变量》的自定义变量中有所提及

1

$ set

set -u

执行脚本时，如果遇到不存在的变量，Bash 默认忽略它。大多数情况下，这不是开发者想要的行为，遇到变量不存在，脚本应该报错，而不是一声不响地往下执行。

set -u就用来改变这种行为。脚本在头部加上它，遇到不存在的变量就会报错，并停止执行。

-u还有另一种写法-o nounset，两者是等价的。

简单实践如下：

创建脚本set_u.sh

1
2
3
4

#!/usr/bin/env bash

echo $name
echo script finished

赋权后执行

1
2
3

$ ./set_u.sh 

script finished

添加set -u

1
2
3
4
5

#!/usr/bin/env bash
set -u

echo $name
echo script finished

赋权后执行

1
2

$ ./set_u.sh 
./set_u.sh: line 4: name: unbound variable

提示变量未绑定，报错。

set -x

默认情况下，脚本执行后，只输出运行结果，没有其他内容。如果多个命令连续执行，它们的运行结果就会连续输出。有时会分不清，某一段内容是什么命令产生的。

set -x用来在运行结果之前，先输出执行的那一行命令。这对于调试复杂的脚本是很有用的。可用于错误定位。

-x还有另一种写法-o xtrace。

脚本当中如果要关闭命令输出，可以使用set +x。于set -x结合，就可以只对某一段脚本开启这个功能

简单实践如下：

创建set_x.sh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

#!/usr/bin/env bash

set -x
for item in {1..10}; do
    if [ "$item" -lt 5 ]; then
        echo "${item}"
    fi
done
set +x

echo script finished

赋权后执行

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

[root@iZbp1ag455gf8nrfdeqknwZ shell_set]# ./set_x.sh 
+ for item in '{1..10}'
+ '[' 1 -lt 5 ']'
+ echo 1
1
+ for item in '{1..10}'
+ '[' 2 -lt 5 ']'
+ echo 2
2
+ for item in '{1..10}'
+ '[' 3 -lt 5 ']'
+ echo 3
3
+ for item in '{1..10}'
+ '[' 4 -lt 5 ']'
+ echo 4
4
+ for item in '{1..10}'
+ '[' 5 -lt 5 ']'
+ for item in '{1..10}'
+ '[' 6 -lt 5 ']'
+ for item in '{1..10}'
+ '[' 7 -lt 5 ']'
+ for item in '{1..10}'
+ '[' 8 -lt 5 ']'
+ for item in '{1..10}'
+ '[' 9 -lt 5 ']'
+ for item in '{1..10}'
+ '[' 10 -lt 5 ']'
+ set +x
script finished

可以看到 for 循环的执行过程看的非常的清楚。

Bash 的错误处理

如果脚本里面有运行失败的命令（返回值非0），Bash 默认会继续执行后面的命令。

1
2
3
4

#!/usr/bin/env bash

foo
echo bar

上面脚本中，foo是一个不存在的命令，执行时会报错。但是，Bash 会忽略这个错误，继续往下执行。

1
2
3

$ bash script.sh
script.sh:行3: foo: 未找到命令
bar

可以看到，Bash 只是显示有错误，并没有终止执行。

这种行为很不利于脚本安全和除错。实际开发中，如果某个命令失败，往往需要脚本停止执行，防止错误累积。这时，一般采用下面的写法。

1

command || exit 1

上面的写法表示只要command有非零返回值，脚本就会停止执行。

如果停止执行之前需要完成多个操作，就要采用下面三种写法。

1
2
3
4
5
6
7
8
9

# 写法一
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

另外，除了停止执行，还有一种情况。如果两个命令有继承关系，只有第一个命令成功了，才能继续执行第二个命令，那么就要采用下面的写法。

1

command1 && command2

我们在《Bash 的基本语法》的命令的有条件的组合小节中曾经学习过Command1 && Command2和Command1 || Command2这两个命令

set -e

上面这些写法多少有些麻烦，容易疏忽。set -e从根本上解决了这个问题，它使得脚本只要发生错误，包括方法内部出现错误，就会终止执行。-e还有另一种写法-o errexit。

简单实践如下：

创建脚本set_e.sh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

#!/usr/bin/env bash

function throw_exception(){
    echo function error
    return 1
}

throw_exception

echo script finished

赋权后执行

1
2
3

$ ./set_e.sh 
function error
script finished

添加set -e

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

#!/usr/bin/env bash

set -e

function throw_exception(){
    echo function error
    return 1
}

throw_exception

echo script finished

赋权后执行

1
2

$ ./set_e.sh 
function error

可见直接停止了执行。

set -e根据返回值来判断，一个命令是否运行失败。但是，某些命令的非零返回值可能不表示失败，或者开发者希望在命令失败的情况下，脚本继续执行下去。这时可以暂时关闭set -e，该命令执行结束后，再重新打开set -e。

set +e表示关闭-e选项，set -e表示重新打开-e选项。

还有一种方法是使用command || true，使得该命令即使执行失败，脚本也不会终止执行。

1
2
3
4
5

#!/bin/bash
set -e

foo || true
echo bar

上面代码中，true使得这一行语句总是会执行成功，后面的echo bar会执行。

set -o pipefail

set -e有一个例外情况，就是不适用于管道命令。

所谓管道命令，就是多个子命令通过管道运算符（|）组合成为一个大的命令。Bash 会把最后一个子命令的返回值，作为整个命令的返回值。也就是说，只要最后一个子命令不失败，管道命令总是会执行成功，因此它后面命令依然会执行，set -e就失效了。

创建set_o.sh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

#!/usr/bin/env bash

set -e

function throw_exception(){
    echo function error
    return 1
}

throw_exception | echo pipline execute

echo script finished

赋权后执行

1
2
3

$ ./set_o.sh 
pipline execute
script finished

可以发现脚本的执行并没有停止，set -o pipefail用来解决这种情况，只要一个子命令失败，整个管道命令就失败，脚本就会终止执行。

添加set -o pipefail

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

#!/usr/bin/env bash

set -eo pipefail

function throw_exception(){
    echo function error
    return 1
}

throw_exception | echo pipline execute

echo script finished

执行

1
2

$ ./set_o.sh 
pipline execute

可以看到整个管道命令的每个部分依然会完整执行，但是执行之后即停止。

set -E

一旦设置了-e参数，会导致函数内的错误不会被trap命令捕获。-E参数可以纠正这个行为，使得函数也能触发trap命令。

关于 trap 命令，可参考《mktemp 命令和 trap 命令》中的trap 命令小节

简单实践如下：

创建set_E.sh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

#!/usr/bin/env bash

set -eo pipefail

trap "echo ERR trap fired!" ERR

function inner_error(){
    return 1
}

function test(){
    echo function execute
    inner_error
    echo function finish
}

test 

echo script finished

赋权后执行

1
2

$ ./set_E.sh 
function execute

脚本停止执行，但是没有出发 trap 命令，添加set -E

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

#!/usr/bin/env bash

set -Eeo pipefail

trap "echo ERR trap fired!" ERR

function inner_error(){
    return 1
}

function test(){
    echo function execute
    inner_error
    echo function finish
}

test 

echo script finished

赋权后执行

1
2
3

$ ./set_E.sh 
function execute
ERR trap fired!

成功被 trap 命令捕获。

trap命令在错误处理中的用处很大，可以让我们在出现错误之后执行相关的操作。

其他参数

set命令还有一些其他参数。

  • set -n：等同于set -o noexec，不运行命令，只检查语法是否正确。

  • set -f：等同于set -o noglob，表示不对通配符进行文件名扩展。

    这个我们在《Bash 的模式拓展》的简介小节了解过

  • set -v：等同于set -o verbose，表示打印 Shell 接收到的每一行输入。

  • set -o noclobber：防止使用重定向运算符>覆盖已经存在的文件。

上面的-f和-v参数，可以分别使用set +f、set +v关闭。

set 命令总结

上面重点介绍的set命令的几个参数，一般都放在一起使用。

1
2
3
4
5
6
7
8
9

# 写法一
set -Eeuxo pipefail

# 写法二
set -Eeux
set -o pipefail

# 不开启 -x
set -ueEo pipefail

这两种写法建议放在所有 Bash 脚本的头部。同时配合 trap 命令trap "echo ERR trap fired!" ERR

另一种办法是在执行 Bash 脚本的时候，从命令行传入这些参数。

1

$ bash -ueEo pipefail script.sh

一般主要会bash -x这样使用-x参数，其他参数比如-ueEo pipefail则直接写到脚本之中。

shopt 命令

在《Bash 的模式拓展》的shopt 命令小节已经学习过，在其他多个小节中也有提及

shopt命令用来调整 Shell 的参数，跟set命令的作用很类似。也用来修改（子）Shell 环境的运行参数，即定制环境。

之所以会有这两个类似命令的主要原因是，set是从 Ksh 继承的，属于 POSIX 规范的一部分，而shopt是 Bash 特有的。

直接输入shopt可以查看所有参数，以及它们各自打开和关闭的状态。

1

$ shopt

shopt命令后面跟着参数名，可以查询该参数是否打开。

1
2

$ shopt globstar
globstar  off

上面例子表示globstar参数默认是关闭的。

（1）-s

-s用来打开某个参数。

1

$ shopt -s optionNameHere

（2）-u

-u用来关闭某个参数。

1

$ shopt -u optionNameHere

举例来说，histappend这个参数表示退出当前 Shell 时，将操作历史追加到历史文件中。这个参数默认是打开的，如果使用下面的命令将其关闭，那么当前 Shell 的操作历史将替换掉整个历史文件。

1

$ shopt -u histappend

（3）-q

-q的作用也是查询某个参数是否打开，但不是直接输出查询结果，而是通过命令的执行状态（$?）表示查询结果。如果状态为0，表示该参数打开；如果为1，表示该参数关闭。

1
2
3

$ shopt -q globstar
$ echo $?
1

上面命令查询globstar参数是否打开。返回状态为1，表示该参数是关闭的。

这个用法主要用于脚本，供if条件结构使用。下面例子是如果打开了这个参数，就执行if结构内部的语句。

1
2
3

if (shopt -q globstar); then
  ...
fi

也就是说，我们可以很方便地通过脚本来保持某个环节变量的开启

更新于 2023-10-22 
CC BY-NC 4.0
返回 | 主页
0%