添加摘要与标签字段后Shell脚本出现Unbound variable error的解决方法

阿华AIGC实验室

2026-5-20

解决Shell脚本新增字段后的Unbound Variable Error问题

嘿，我碰到过类似的坑！先给你理清楚这个问题的核心：set -u触发的"Unbound variable"错误，是因为你引用了一个从来没被赋值过的变量——注意，是完全没被定义过，哪怕赋值为空字符串（summary=""）都不会触发这个错误。而bash -n和shellcheck这类静态检查工具，没法预判脚本运行时的分支执行情况，所以才会漏检。

下面给你一步步排查和解决的方法：

1. 先精准定位出问题的变量

首先，确保你的脚本开头加了set -eu -o pipefail（比单独的set -u更严格），这样报错时会直接告诉你是哪一行的哪个变量没定义。比如你会看到类似line 15: tags: unbound variable的提示，一下子就能锁定目标。

2. 检查变量的定义逻辑，避开常见坑

最容易踩的几个雷：

条件分支里漏了赋值：比如你只在用户输入内容时才给summary或tags赋值，用户直接回车跳过的话，变量就从来没被定义过。举个错误例子：
```
read -p "输入摘要：" input
if [ -n "$input" ]; then
    summary="$input"
fi
# 用户直接回车的话，summary根本没被创建，引用时就炸了
```
解决：提前给变量赋默认值（哪怕是空），比如脚本开头就加summary=""，或者直接把read的结果赋值给变量：read -p "输入摘要：" summary——用户回车的话，summary是空字符串，但已经被定义了，set -u不会报错。
位置参数/间接引用没处理默认值：如果你的变量是从位置参数（比如tags="$2"）或者间接变量（比如var="summary"; echo "${!var}"）来的，当参数没传或者间接变量名不存在时，就会触发错误。
解决：用默认值语法兜底，比如tags="${2:-}"（如果$2不存在，tags被设为空）；间接引用的话，先检查变量是否存在：if [ -v "$varname" ]; then echo "${!varname}"; else echo ""; fi。
变量在未执行的分支里定义：比如你把summary的赋值放在某个if分支里，但运行时这个分支没走，导致变量从未被创建。这种情况静态检查很难发现，得靠调试。

3. 用调试模式抓细节

如果还是找不到问题，在脚本开头加set -x，这样脚本运行时会打印每一步执行的命令和变量值，你就能清楚看到哪个变量在引用时还没被定义。

4. 给你一个修复后的示例

比如原来的错误代码可能是这样：

#!/bin/bash
set -u

read -p "文章标题：" title
read -p "摘要（可选）：" input_sum
if [ -n "$input_sum" ]; then
    summary="$input_sum"
fi
read -p "标签（可选）：" input_tags
if [ -n "$input_tags" ]; then
    tags="$input_tags"
fi

cat > draft.md <<EOF
# $title
*摘要：* $summary
*标签：* $tags
EOF

修复后：

#!/bin/bash
set -u

# 提前赋默认值，确保变量始终存在
summary=""
tags=""

read -p "文章标题：" title
read -p "摘要（可选）：" summary
read -p "标签（可选）：" tags

cat > draft.md <<EOF
# $title
*摘要：* ${summary:-暂无摘要}
*标签：* ${tags:-暂无标签}
EOF

这里用${summary:-暂无摘要}是为了空值时显示友好提示，如果你想保留空，直接用$summary就行，因为它已经被定义了。