在原生Bash中实现带错误提示的断言且不退出Shell的方法

需求说明 #

在未安装额外工具的原生Bash环境中，需要实现以下校验逻辑：

• 校验指定变量或值的合法性
• 当值不符合预期时输出错误提示
• 仅返回失败状态（false/返回码1），不退出当前Shell窗口，由上下文逻辑决定后续操作（禁止使用exit命令）

现有实现的问题 #

目前存在两种常见写法，但都有明显缺陷：

1. 可读性差的紧凑写法：

[[ -n "$some_val" && -n "$other_val" ]] || {echo "Unable to retrieve xxx from yyy"; false}

逻辑堆叠在一起，维护和阅读成本高。

2. 清晰但冗长的写法：

if ! (test -n "$some_val" && test -n "$other_val"); then
  echo "Unable to retrieve xxx from yyy"
  false
fi

逻辑清晰但代码行数多，重复场景下冗余度高。

简洁清晰的解决方案 #

利用Bash的自定义函数特性，可以实现类似你理想中的简洁写法，完全符合原生环境要求：

方案1：通用失败提示函数 #

定义一个fail函数，专门处理错误提示和状态返回：

fail() {
    # 将错误信息输出到标准错误流（stderr），符合Unix工具的错误输出规范
    echo "$1" >&2
    # 返回失败状态码（1对应false）
    return 1
}

使用时直接按你理想的形式调用：

[[ -n "$some_val" && -n "$other_val" ]] || fail "Unable to retrieve xxx from yyy"

方案2：针对单个变量的校验函数 #

如果需要对每个变量单独给出精准提示，可以定义更针对性的校验函数：

# 校验变量非空，参数1为变量名（用于提示），参数2为变量值
check_not_empty() {
    local var_name="$1"
    local var_value="$2"
    if [[ -z "$var_value" ]]; then
        echo "Error: $var_name is missing or empty" >&2
        return 1
    fi
}

使用示例：

# 依次校验多个变量，任意一个失败则终止后续校验并返回失败状态
check_not_empty "some_val" "$some_val" && check_not_empty "other_val" "$other_val"

方案优势 #

• 完全基于原生Bash特性，无需安装任何额外工具
• 代码结构清晰，可读性强，符合你期望的简洁形式
• 仅返回失败状态，不会退出Shell，完全由上下文逻辑控制后续流程

内容的提问来源于stack exchange，提问作者Jun-Dai Bates-Kobashigawa