开启 set -u 后脚本报错“未绑定变量”，最推荐的调试方式是先用 set +u 临时关闭严格模式定位行号，再根据业务逻辑选择补充默认值或修正变量名。适用场景为生产环境脚本稳定性加固，风险边界在于临时关闭期间可能掩盖真正的逻辑缺陷。

命令速用版

以下命令用于快速定位和临时绕过报错，便于调试。

# 临时关闭未定义变量报错，继续运行脚本
set +u

# 开启调试模式，打印执行过程和变量值
bash -x script.sh

# 变量未定义时使用默认值，避免报错
echo "${MY_VAR:-default_value}"

# 变量未定义时直接报错并退出，带自定义信息
echo "${MY_VAR?Error: MY_VAR is not set}"

为什么会这样

set -u 开启后，Shell 会将引用未定义变量视为错误并终止执行。这是 Bash 内置的安全机制，旨在防止因变量名为空导致意外操作，例如 rm -rf $EMPTY_VAR 变成 rm -rf /。

默认情况下，Shell 遇到未定义变量会将其解析为空字符串，这在某些场景下会掩盖逻辑错误。开启 set -u 后，任何未赋值的变量引用都会触发 unbound variable 错误，强制开发者显式处理变量状态。

分步处理

按以下步骤修复 set -u 引发的报错，确保脚本既安全又健壮。

步骤 1：定位报错变量
查看报错信息中的变量名和行号。若报错信息不明确，使用 bash -x script.sh 运行脚本，观察最后一行输出的变量引用。

步骤 2：判断变量意图
确认该变量是否应该必须有值。若业务逻辑要求该变量必须存在，则检查上游赋值逻辑或环境变量配置。若该变量可选，则进入步骤 3。

步骤 3：修改变量引用
对于可选变量，将 $VAR 修改为 ${VAR:-} 或 ${VAR:-default}。对于必须存在的变量，检查拼写是否与环境赋值一致，确保大小写匹配。

步骤 4：恢复严格模式
修复完成后，确保脚本头部保留 set -u 或 set -euo pipefail，不要永久使用 set +u 绕过检查。

怎么验证是否生效

修复后需验证脚本在严格模式下能否正常运行且逻辑符合预期。

检查点 1：退出状态码
运行脚本后执行 echo $?，确认返回值为 0。若仍报错，说明仍有未定义变量未被处理。

检查点 2：无报错信息
确认标准错误输出 stderr 中不再出现 unbound variable 相关提示。

检查点 3：逻辑验证
若使用了默认值 ${VAR:-default}，需验证默认值是否影响后续逻辑，例如空字符串与默认值在条件判断中的区别。

常见坑

调试 set -u 时容易忽略的特殊场景，需谨慎处理。

数组索引越界
访问不存在的数组索引也会触发 unbound variable 错误，需先检查数组长度或使用 ${ARRAY[@]:-}。

位置参数 $1 $2
脚本未传参时引用 $1 会报错，建议使用 ${1:-} 或在脚本开头检查参数数量。

特殊变量 $@ 和 $*
在某些 Bash 版本中，当没有位置参数时，引用 $@ 可能触发报错，建议先用 [ $# -gt 0 ] 判断。

临时关闭的风险
set +u 仅用于调试定位，不要提交到版本控制。生产环境应保持 set -u 开启以防止空变量引发事故。

常见问题

set -u 和 set -euo pipefail 有什么区别？

set -u 仅检查未定义变量，set -euo pipefail 是组合选项，同时包含错误退出、未定义变量检查和管道错误传递。生产环境建议直接使用 set -euo pipefail 获得更全面的保护。

如何只忽略特定变量的未定义报错？

Shell 不支持针对单个变量忽略 set -u 检查，必须通过 ${VAR:-} 语法显式提供默认值来处理特定变量。

为什么设置了环境变量脚本还是报错？

检查变量名大小写是否完全一致，Shell 变量区分大小写。若脚本内部使用了 set -u 且变量未在脚本内赋值，需确保环境变量在脚本执行前已导出。

参考来源

GNU Bash Manual: The Set Builtin
https://www.gnu.org/software/bash/manual/html_node/The-Set-Builtin.html

GNU Bash Manual: Shell Parameter Expansion
https://www.gnu.org/software/bash/manual/html_node/Shell-Parameter-Expansion.html