如何让Bash提示未定义变量但仍继续运行脚本？

针对脚本中有大量变量、不想逐个检查的场景，推荐以下两种无需修改原有变量引用的解决方案：

方案一：结合set -u与ERR陷阱捕获错误 #

通过开启set -u检测未定义变量，同时用trap捕获错误并输出警告，让脚本继续执行：

#!/bin/bash

# 处理未绑定变量错误的函数
handle_unbound_var() {
    local exit_code=$?
    # 判断是否为未绑定变量触发的错误
    if [[ $exit_code -eq 1 && ! $BASH_COMMAND =~ = ]]; then
        echo "警告：使用了未定义的变量 - $BASH_COMMAND" >&2
        # 返回0使脚本继续执行
        return 0
    fi
    # 其他错误保持默认终止逻辑
    return $exit_code
}

# 启用未定义变量检测
set -u
# 设置错误陷阱
trap handle_unbound_var ERR

# 测试示例
echo "已定义变量：$HOME"
echo "未定义变量：$undefined_var"
echo "脚本继续执行至此"

原理说明 #

set -u会在使用未定义变量时触发错误并终止脚本，而ERR陷阱会捕获该错误，通过自定义函数判断错误类型：如果是未绑定变量导致的错误，就输出警告并返回0，让脚本继续运行；其他类型的错误则保持原有终止逻辑。

方案二：利用DEBUG陷阱预检查变量 #

通过DEBUG陷阱在每个命令执行前，扫描其中的变量引用并检查是否已定义，提前输出警告：

#!/bin/bash

# 预检查变量是否定义的函数
check_unbound_vars() {
    local cmd=$BASH_COMMAND
    # 匹配命令中的变量引用（简单匹配$var格式）
    while [[ $cmd =~ \$([a-zA-Z_][a-zA-Z0-9_]*) ]]; do
        local var_name=${BASH_REMATCH[1]}
        # 检查变量是否未设置
        if [[ ! -v $var_name ]]; then
            echo "警告：即将使用未定义的变量 '$var_name'" >&2
        fi
        # 移除已匹配的部分，继续查找剩余变量
        cmd=${cmd#*${BASH_REMATCH[0]}}
    done
}

# 设置调试陷阱，每个命令执行前触发检查
trap 'check_unbound_vars' DEBUG

# 测试示例
echo "已定义变量：$HOME"
echo "未定义变量：$undefined_var"
echo "脚本继续执行至此"

原理说明 #

DEBUG陷阱会在脚本中每个命令执行前触发，自定义函数通过正则匹配命令中的变量引用，用[[ ! -v $var_name ]]检查变量是否未定义，若未定义则输出警告。这种方式无需开启set -u，不会终止脚本，但对复杂变量表达式（如${var:-default}）的匹配可能存在局限性。

内容的提问来源于stack exchange，提问作者mauroformigoni