检查环境变量是否在 Unix shell 脚本中设置的简洁方法是什么？

参数扩展

显而易见的答案是使用一种特殊形式的参数扩展：

: ${STATE?"Need to set STATE"}
: ${DEST:?"Need to set DEST non-empty"}

或者，更好（参见下面的“双引号位置”部分）：

: "${STATE?Need to set STATE}"
: "${DEST:?Need to set DEST non-empty}"

第一个变体（仅使用 ?）需要设置 STATE，但 STATE=""（一个空字符串）是可以的 - 不完全是您想要的，而是替代的和旧的表示法。

第二个变体（使用 :?）需要设置 DEST 且非空。

如果您不提供任何消息，shell 将提供默认消息。

${var?} 构造可移植回版本 7 UNIX 和 Bourne Shell（1978 年左右）。 ${var:?} 构造稍微更新一些：我认为它在 1981 年左右出现在 System III UNIX 中，但在那之前它可能已经出现在 PWB UNIX 中。因此它存在于 Korn Shell 和 POSIX shell 中，包括特别是 Bash。

它通常记录在 shell 手册页中称为 Parameter Expansion 的部分中。例如，bash 手册说：

${parameter:?word} 如果为 Null 或未设置，则显示错误。如果 parameter 为 null 或未设置，则 word 的扩展（或如果 word 不存在，则将显示消息）写入标准错误，并且 shell，如果它不是交互式的，则退出。否则，参数的值被替换。

结肠指挥部

我可能应该补充一点，冒号命令只是对其参数进行评估，然后成功。它是原始的 shell 注释符号（在 '#' 到行尾之前）。很长一段时间以来，Bourne shell 脚本都以冒号作为第一个字符。 C Shell 将读取脚本并使用第一个字符来确定它是用于 C Shell（'#' 散列）还是 Bourne shell（':' 冒号）。然后内核参与进来，增加了对“#!/path/to/program”的支持，Bourne shell 得到了“#”注释，冒号约定被搁置了。但是如果你遇到一个以冒号开头的脚本，现在你就会知道为什么了。

双引号的位置

blong 在 comment 中问：

对这个讨论有什么想法吗？ https://github.com/koalaman/shellcheck/issues/380#issuecomment-145872749

讨论的要点是：

...但是，当我对其进行 shellcheck（版本为 0.4.1）时，我收到以下消息：在 script.sh 第 13 行：：${FOO:?"The environment variable 'FOO' must be set and non-empty"} ^ -- SC2086：双引号以防止通配符和分词。在这种情况下我应该做什么有什么建议吗？

简短的回答是“按照 shellcheck 的建议做”：

: "${STATE?Need to set STATE}"
: "${DEST:?Need to set DEST non-empty}"

为了说明原因，请研究以下内容。请注意，: 命令不会回显其参数（但 shell 会评估参数）。我们想查看参数，因此下面的代码使用 printf "%s\n" 代替 :。

$ mkdir junk
$ cd junk
$ > abc
$ > def
$ > ghi
$ 
$ x="*"
$ printf "%s\n" ${x:?You must set x}    # Careless; not recommended
abc
def
ghi
$ unset x
$ printf "%s\n" ${x:?You must set x}    # Careless; not recommended
bash: x: You must set x
$ printf "%s\n" "${x:?You must set x}"  # Careful: should be used
bash: x: You must set x
$ x="*"
$ printf "%s\n" "${x:?You must set x}"  # Careful: should be used
*
$ printf "%s\n" ${x:?"You must set x"}  # Not quite careful enough
abc
def
ghi
$ x=
$ printf "%s\n" ${x:?"You must set x"}  # Not quite careful enough
bash: x: You must set x
$ unset x
$ printf "%s\n" ${x:?"You must set x"}  # Not quite careful enough
bash: x: You must set x
$ 

请注意，当整个表达式不在双引号中时，$x 中的值如何扩展为第一个 *，然后是文件名列表。这是 shellcheck 建议应该修复的问题。我还没有验证它不反对表达式用双引号括起来的形式，但这是一个合理的假设，它可以。

---

尝试这个：

[ -z "$STATE" ] && echo "Need to set STATE" && exit 1;

---

您的问题取决于您使用的外壳。

Bourne shell 对您所追求的东西的影响很小。

但...

它确实有效，几乎无处不在。

试着远离 csh。与 Bourne shell 相比，它添加的花里胡哨很有用，但它现在真的吱吱作响。如果您不相信我，请尝试在 csh 中分离出 STDERR！ （-：

这里有两种可能。上面的例子，即使用：

${MyVariable:=SomeDefault}

第一次您需要参考 $MyVariable。这需要环境。 var MyVariable，如果当前未设置，则将 SomeDefault 的值分配给变量以供以后使用。

您还可以：

${MyVariable:-SomeDefault}

它只是用 SomeDefault 代替您使用此构造的变量。它不会将值 SomeDefault 赋给变量，在遇到此语句后，MyVariable 的值仍将为 null。

---

当然，最简单的方法是将 -u 开关添加到 shebang（脚本顶部的行），假设您使用的是 bash：

#!/bin/sh -u

如果任何未绑定的变量潜伏在其中，这将导致脚本退出。

---

${MyVariable:=SomeDefault}

如果设置了 MyVariable 并且不为空，它将重置变量值（= 没有任何反应）。
否则，MyVariable 设置为 SomeDefault。

上面将尝试执行 ${MyVariable}，所以如果您只想设置变量，请执行以下操作：

MyVariable=${MyVariable:=SomeDefault}

---

在我看来，#!/bin/sh 的最简单和最兼容的检查是：

if [ "$MYVAR" = "" ]
then
   echo "Does not exist"
else
   echo "Exists"
fi

同样，这适用于 /bin/sh，并且在旧的 Solaris 系统上也兼容。

---

bash 4.2 引入了 -v 运算符，用于测试名称是否设置为 any 值，甚至是空字符串。

$ unset a
$ b=
$ c=
$ [[ -v a ]] && echo "a is set"
$ [[ -v b ]] && echo "b is set"
b is set
$ [[ -v c ]] && echo "c is set"
c is set

---

我一直用：

if [ "x$STATE" == "x" ]; then echo "Need to set State"; exit 1; fi

恐怕没有那么简洁。

在 CSH 下你有 $?STATE。

---

对于像我这样的未来人，我想更进一步并参数化 var 名称，这样我就可以遍历一个可变大小的变量名称列表：

#!/bin/bash
declare -a vars=(NAME GITLAB_URL GITLAB_TOKEN)

for var_name in "${vars[@]}"
do
  if [ -z "$(eval "echo \$$var_name")" ]; then
    echo "Missing environment variable $var_name"
    exit 1
  fi
done

---

我们可以编写一个很好的断言来一次检查一堆变量：

#
# assert if variables are set (to a non-empty string)
# if any variable is not set, exit 1 (when -f option is set) or return 1 otherwise
#
# Usage: assert_var_not_null [-f] variable ...
#
function assert_var_not_null() {
  local fatal var num_null=0
  [[ "$1" = "-f" ]] && { shift; fatal=1; }
  for var in "$@"; do
    [[ -z "${!var}" ]] &&
      printf '%s\n' "Variable '$var' not set" >&2 &&
      ((num_null++))
  done

  if ((num_null > 0)); then
    [[ "$fatal" ]] && exit 1
    return 1
  fi
  return 0
}

示例调用：

one=1 two=2
assert_var_not_null one two
echo test 1: return_code=$?
assert_var_not_null one two three
echo test 2: return_code=$?
assert_var_not_null -f one two three
echo test 3: return_code=$? # this code shouldn't execute

输出：

test 1: return_code=0
Variable 'three' not set
test 2: return_code=1
Variable 'three' not set

更多此类断言：https://github.com/codeforester/base/blob/master/lib/assertions.sh

---

这也可以是一种方式：

if (set -u; : $HOME) 2> /dev/null
...
...

http://unstableme.blogspot.com/2007/02/checks-whether-envvar-is-set-or-not.html

---

上述解决方案都不适用于我的目的，部分原因是我在开始漫长的过程之前检查了环境中需要设置的开放式变量列表。我最终得到了这个：

mapfile -t arr < variables.txt

EXITCODE=0

for i in "${arr[@]}"
do
   ISSET=$(env | grep ^${i}= | wc -l)
   if [ "${ISSET}" = "0" ];
   then
      EXITCODE=-1
      echo "ENV variable $i is required."
   fi
done

exit ${EXITCODE}

---

我倾向于在登录 shell 中加载函数，而不是使用外部 shell 脚本。我使用这样的东西作为辅助函数来检查环境变量而不是任何设置变量：

is_this_an_env_variable ()
    local var="$1"
    if env |grep -q "^$var"; then
       return 0
    else
       return 1
    fi
 }

---

$? 语法非常简洁：

if [ $?BLAH == 1 ]; then 
    echo "Exists"; 
else 
    echo "Does not exist"; 
fi

---