命令行与文本处理 / 系统课时
未定义变量为什么应该报错
未定义变量为什么应该报错
Shell 默认会把不存在的变量展开为空字符串,这在拼接路径、生成参数或执行删除与复制命令时尤其危险。启用 set -u 后,脚本会在读取未定义变量时立即失败,让变量名拼错、环境变量缺失等问题尽早暴露。
学习目标
- 理解未定义变量被当成空字符串时可能造成的风险
- 使用
set -u在变量缺失时立即终止脚本 - 区分必须存在的变量与允许使用默认值的变量
默认行为为什么危险
Bash 在未启用严格检查时,读取一个从未赋值的普通变量通常只会得到空字符串。问题不在于“少打印几个字符”,而在于空值可能继续参与路径和命令参数的构造。
例如脚本原本希望把文件写入 $BACKUP_DIR/app.tar.gz。如果变量名写错或环境变量没有注入,路径可能退化成 /app.tar.gz。脚本仍可能继续执行,错误直到更晚才暴露,甚至操作到错误的位置。
用 set -u 立即发现变量缺失
set -u 也可以写成 set -o nounset。启用后,Bash 在展开未定义变量时会报告错误并停止当前脚本,而不是默默把它替换为空字符串。
下面的脚本故意没有定义 TARGET_DIR:
#!/usr/bin/env bash
set -u
job_name="archive"
printf 'job=%s\n' "$job_name"
printf 'target=%s\n' "$TARGET_DIR"预期结果
job=archive
<PATH>: line <ID>: TARGET_DIR: unbound variable实际错误信息中的脚本路径和行号会随保存位置及代码行数不同而变化,但关键结果一致:访问 TARGET_DIR 时立即报错,并以非零状态结束脚本。
这种失败方式比让空字符串继续流入 cp、rm、curl 等后续命令更容易定位,也更适合自动化任务和 CI 环境。
允许为空时要显式表达
并不是所有缺失变量都应该让脚本失败。可选配置应通过参数展开明确给出默认行为,例如 ${LOG_LEVEL:-info} 表示变量未设置或为空时使用 info。
对于必须由外部提供的变量,可以使用 ${BACKUP_DIR:?BACKUP_DIR is required}。这种写法不仅会终止执行,还能提供更明确的错误说明,适合检查部署环境变量和脚本入口参数。
不要为了绕过 set -u 而给所有变量随意补空字符串。更可靠的做法是区分“必须存在”和“确实可选”两类输入,再分别使用错误检查或默认值。
什么时候启用
自动备份、日志归档、批量发布等脚本通常会读取大量环境变量和路径参数,变量名拼错一次就可能影响整个批次,因此很适合启用 set -u。常见脚本也会把它与其他安全选项组合成 set -euo pipefail,但三个选项解决的问题不同,不能把它们理解成一个不可拆分的开关。
当脚本需要判断某个变量是否存在时,不应直接展开它,而应使用 ${VAR:-}、${VAR+x} 等能够安全处理未设置变量的形式。这样既保留 set -u 的保护作用,又能明确表达可选变量的业务含义。