如何判断环境变量为空

1 Overview

今天在看 Spark 的脚本的时候，发现很多变量都有用到 {VARIABLE+x} 这种格式，如下：

...
...
...
&& if ! [ -z ${SPARK_MOUNTED_CLASSPATH+x} ]; then SPARK_CLASSPATH="$SPARK_MOUNTED_CLASSPATH:$SPARK_CLASSPATH"; fi \
...
...
...

-z 很容易理解，在 Shell 脚本里就是表示后面这个变量是否为空，也做 zero 的意思。那后面的 +x 呢？

2 Example

以下例子是先定义了 VARIABLE 变量为空，然后判断为空的时候输出需要设置环境变量，不为空则打印变量值。

VARIABLE=
if ! [ -z ${VARIABLE} ]; then
    echo "${VARIABLE} was defined"
else
    echo "Need to set environment var $VARIABLE" && exit 1;
fi

显示结果如下。结果判断是正确的。

➜  /tmp cat x.sh
VARIABLE=
if ! [ -z ${VARIABLE} ]; then
    echo "${VARIABLE} was defined"
else
    echo "Need to set environment var $VARIABLE" && exit 1;
fi
➜  /tmp ./x.sh
Need to set environment var

然后对脚本略加修改，也就是 ${VARIABLE+x}。运行后发现，结果有点诡异，明明变量是空的，为什么会报告说变量定义了呢？

➜  /tmp cat x.sh
VARIABLE=
if ! [ -z ${VARIABLE+x} ]; then
    echo "${VARIABLE} was defined"
else
    echo "Need to set environment var $VARIABLE" && exit 1;
fi
➜  /tmp ./x.sh
 was defined

3 StackOverflow

关于以上的区别，我在 StackOverflow 上找到关键的参考信息。

https://stackoverflow.com/questions/3601515/how-to-check-if-a-variable-is-set-in-bash

从上面的回答中可以找到相关的文档。

http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_06_02

我大概解释一下，${VARIABLE+x} 这种称为 parameter expansion，这个变量的含义是，如果 VARIABLE 是 unset 或者空的，则会用 x 来替换这个值，最后再用刚刚的例子测试一下。

➜  /tmp cat x.sh
VARIABLE=
if ! [ -z ${VARIABLE+x} ]; then
    echo "${VARIABLE+x} was defined"
else
    echo "Need to set environment var $VARIABLE" && exit 1;
fi
➜  /tmp ./x.sh
x was defined

可以看到 VARIABLE 为空值 null，所以会用 x 来替换 ${VARIABLE 的值，也就是说此时 ${VARIABLE}=x，所以最终会输出 x 的值。