Shellcheck报SC2154：单行trap中status引用未赋值的解决方法

原始脚本 #

#!/bin/bash

set -e
trap 'status=$?; echo "$(basename ${BASH_SOURCE[0]}): exit status: $status"' EXIT

exit 7

该脚本运行符合预期（会输出退出状态7），但Shellcheck报出如下警告：

In sample.sh line 4:
trap 'status=$?; echo "$(basename ${BASH_SOURCE[0]}): exit status: $status"' EXIT
     ^-- SC2154 (warning): status is referenced but not assigned.

改写方案 #

方法一：提前声明status变量 #

在脚本全局作用域提前声明status变量，让Shellcheck确认该变量已被定义，直接消除警告：

#!/bin/bash

# 提前声明status变量，解决SC2154静态分析误判
status=0
set -e
trap 'status=$?; echo "$(basename ${BASH_SOURCE[0]}): exit status: $status"' EXIT

exit 7

方法二：简化trap逻辑（仅限无中间命令场景） #

如果trap中不需要执行basename这类会改变$?的命令，也可以直接使用$?输出状态码，避免变量引用：

#!/bin/bash

set -e
trap 'echo "$(basename ${BASH_SOURCE[0]}): exit status: $?"' EXIT

exit 7

注意：原脚本中使用status变量的核心目的是保存exit的状态码，避免basename执行后覆盖$?的值，因此方法一的通用性和可靠性更强。

原因说明 #

Shellcheck的SC2154规则用于检测未定义就被引用的变量。由于trap中的代码属于延迟执行的逻辑，静态分析时无法识别其中的status=$?赋值操作，因此会误判status未定义。提前在全局作用域声明变量，就能让Shellcheck确认变量已存在，从而消除警告。

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