如何同时解决ShellCheck的SC2059与SC2089警告？

要同时消除这两个警告，核心是让printf的格式字符串为字面量（硬编码），同时用变量传递占位符对应的内容，既避免格式字符串被Shell错误展开，也符合ShellCheck对格式字符串的安全要求。

直接解决写法（推荐） #

将格式字符串直接作为printf的第一个参数，占位符内容通过后续变量传递：

if [ -z "$(which valet)" ]; then
    # 格式字符串为字面量，占位符内容用变量传递
    printf -v err '%s is required for this script but the "%s" command is missing. Exiting...' "Laravel Valet" "valet"
    echo "$err"  # 必须给err加引号，防止空格/特殊字符被Shell拆分
    exit 1
fi

复用格式字符串的场景（函数封装） #

如果需要在多处复用该错误提示格式，可封装为函数，既保持复用性又符合ShellCheck规则：

# 封装错误提示函数，格式字符串固定为字面量
print_missing_cmd_error() {
    local component="$1"
    local cmd="$2"
    printf '%s is required for this script but the "%s" command is missing. Exiting...' "$component" "$cmd"
}

if [ -z "$(which valet)" ]; then
    printf -v err "$(print_missing_cmd_error "Laravel Valet" "valet")"
    echo "$err"
    exit 1
fi

为什么之前的写法会触发警告 #

• 第一种写法：直接展开未加引号的$CMD_AVAIL_MSG会导致Shell拆分空格，且格式字符串作为变量展开时，引号/转义会被字面处理，触发SC2089；即使加引号，ShellCheck仍会因为格式字符串是变量而提示风险（SC2059）。
• 第二种写法：数组展开后的内容被当作printf的格式字符串，ShellCheck禁止用变量（包括数组）作为格式字符串，因此触发SC2059。

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