Bash 脚本编程：深入理解退出码与状态

Bash 退出码是命令向脚本传达执行结果的方式。0 表示成功，非零状态表示命令失败或产生了脚本需要处理的结果。

本指南将教你如何读取 $?、使用 exit 设置状态，以及利用退出码在 Bash 自动化中构建更安全的控制流。

理解退出码

在 Bash 中执行的每个命令、函数或脚本在完成后都会返回一个退出码。这是一个整数值，用于表示执行的结果。按照惯例：

0（零）：表示成功。命令执行完毕且无错误。
非零（任何其他整数）：表示失败或错误。不同的非零值有时可以表示特定类型的错误。

这种简单的 0 与 非零 约定是 Bash 运行方式的基础，也是你在脚本中构建条件逻辑的关键。

获取最后一条命令的退出码：`$?`

Bash 提供了一个特殊参数 $?，它保存了最近执行的前台命令的退出码。你可以在任何命令之后立即检查它的值，以确定该命令的结果。

# 示例 1：成功的命令
ls /tmp
echo "'ls /tmp' 的退出码：$?"

# 示例 2：失败的命令（不存在的目录）
ls /nonexistent_directory
echo "'ls /nonexistent_directory' 的退出码：$?"

# 示例 3：grep 找到匹配（成功）
grep "root" /etc/passwd
echo "'grep root /etc/passwd' 的退出码：$?"

# 示例 4：grep 未找到匹配（失败，但符合预期）
grep "nonexistent_user" /etc/passwd
echo "'grep nonexistent_user /etc/passwd' 的退出码：$?"

输出（可能因系统和 /etc/passwd 内容略有不同）：

ls /tmp
# ...（/tmp 中的文件列表）
'ls /tmp' 的退出码：0
ls /nonexistent_directory
ls: 无法访问 '/nonexistent_directory': 没有那个文件或目录
'ls /nonexistent_directory' 的退出码：2
grep "root" /etc/passwd
root:x:0:0:root:/root:/bin/bash
'grep root /etc/passwd' 的退出码：0
grep "nonexistent_user" /etc/passwd
'grep nonexistent_user /etc/passwd' 的退出码：1

注意，grep 在匹配时返回 0，未匹配时返回 1。在 grep 的上下文中，两者都是有效结果，但对于条件逻辑，0 表示成功找到模式。

使用 `exit` 显式设置退出码

在编写自己的脚本或函数时，可以使用 exit 命令后跟一个整数值来显式设置其退出码。这对于向调用进程、父脚本或 CI/CD 管道传达脚本的结果至关重要。

#!/bin/bash

# script_success.sh
echo "此脚本将以成功（0）退出"
exit 0

#!/bin/bash

# script_failure.sh
echo "此脚本将以失败（1）退出"
exit 1

# 测试脚本
./script_success.sh
echo "script_success.sh 的状态：$?"

./script_failure.sh
echo "script_failure.sh 的状态：$?"

输出：

此脚本将以成功（0）退出
script_success.sh 的状态：0
此脚本将以失败（1）退出
script_failure.sh 的状态：1

提示： 如果调用 exit 时没有参数，脚本的退出状态将是 exit 之前最后执行的命令的退出状态。

利用退出码实现控制流

退出码是 Bash 中条件执行的基础，使你能够创建动态且响应迅速的脚本。

条件语句（`if`/`else`）

Bash 中的 if 语句会评估命令的退出码。如果命令以 0（成功）退出，则执行 if 块。否则，执行 else 块（如果存在）。

#!/bin/bash

FILE="/path/to/my/important_file.txt"

if [ -f "$FILE" ]; then # 测试命令 `[` 在文件存在时退出码为 0
    echo "文件 '$FILE' 存在。继续处理..."
    # 在此添加文件处理逻辑
    # 示例：cat "$FILE"
    exit 0
else
    echo "错误：文件 '$FILE' 不存在。"
    echo "中止脚本。"
    exit 1
fi

逻辑运算符（`&&`、`||`）

Bash 提供了强大的短路逻辑运算符，它们依赖于退出码：

command1 && command2：仅当 command1 以 0（成功）退出时，才执行 command2。
command1 || command2：仅当 command1 以 非零（失败）退出时，才执行 command2。

这些对于顺序命令和回退机制非常有用。

#!/bin/bash

LOG_DIR="/var/log/my_app"

# 仅在目录不存在时创建
mkdir -p "$LOG_DIR" && echo "日志目录 '$LOG_DIR' 已确保存在。"

# 尝试启动服务，如果失败，则尝试回退命令
systemctl start my_service || { echo "启动 my_service 失败。尝试回退..."; ./start_fallback.sh; }

# 脚本继续执行所必需的成功命令
copy_data_to_backup_location && echo "数据备份成功。" || { echo "数据备份失败！"; exit 1; }

echo "脚本成功完成。"
exit 0

`set -e`：出错时退出

set -e 选项是一个强大的工具，可以使你的脚本更加健壮。当 set -e 激活时，如果任何命令以非零状态退出，Bash 将立即退出脚本。这可以防止静默失败和级联错误。

#!/bin/bash
set -e # 如果命令以非零状态退出，则立即退出

echo "开始脚本..."

# 此命令将成功
ls /tmp

echo "第一个命令成功。"

# 此命令将失败，由于 'set -e'，脚本将在此退出
ls /nonexistent_path

echo "如果前一个命令失败，此行将永远不会执行。"

exit 0 # 仅当所有前面的命令都成功时，才会执行此行

输出（如果 /nonexistent_path 不存在）：

开始脚本...
# ...（ls /tmp 的输出）
第一个命令成功。
ls: 无法访问 '/nonexistent_path': 没有那个文件或目录

脚本在失败的 ls 命令后终止，并且不会打印“此行将永远不会执行”的消息。

警告： set -e 有例外情况，有些命令会因预期结果而合法地返回非零值。例如，grep 在未找到匹配时返回 1。当你关心结果时，最好使用显式的 if grep -q "pattern" file; then ... fi。

常见退出码场景与最佳实践

虽然 0 表示成功、非零 表示失败是一般规则，但一些非零码具有常见含义，尤其是对于系统命令和内置命令：

0：成功。
1：一般错误，各种问题的总称。
2：误用 shell 内置命令或错误的命令参数。
126：调用的命令无法执行（例如，权限问题，不是可执行文件）。
127：命令未找到（例如，命令名称拼写错误，不在 PATH 中）。
128 + N：命令被信号 N 终止。例如，130（128 + 2）表示命令被 SIGINT（Ctrl+C）终止。

在编写自己的脚本时，坚持使用 0 表示成功。对于失败，1 是表示一般错误的安全默认值。如果你的脚本处理多个不同的错误条件，可以使用更高的非零值（例如 10、20、30）来区分它们，但务必清晰记录这些自定义代码。

健壮脚本编写的最佳实践：

始终检查关键命令：不要假设成功。使用 if 语句或 && 验证关键步骤。
提供信息丰富的错误消息：当脚本失败时，向 stderr 打印清晰的消息，解释出了什么问题以及如何可能修复它。使用 >&2 将输出重定向到标准错误。
```
my_command || { echo "错误：my_command 失败。请检查日志。" >&2; exit 1; }
```
失败时进行清理：使用 trap 确保即使脚本提前退出，临时文件或资源也能被清理。
```
cleanup() {
    echo "正在清理临时文件..."
    rm -f /tmp/my_temp_file_$$
}
trap cleanup EXIT
```
验证输入：尽早检查脚本参数或环境变量，如果无效则退出并显示信息性错误。
记录退出状态：对于复杂的自动化，记录关键操作的退出状态，以便审计和调试。

实际示例：一个健壮的备份脚本片段

以下是如何在实际场景中结合这些概念：

#!/bin/bash
set -e # 如果命令以非零状态退出，则立即退出

BACKUP_SOURCE="/data/app/config"
BACKUP_DEST="/mnt/backup/configs"
TIMESTAMP=$(date +%Y%m%d%H%M%S)
LOG_FILE="/var/log/backup_config_${TIMESTAMP}.log"

# --- 函数 ---
log_message() {
    echo "$(date +%Y-%m-%d_%H:%M:%S) - $1" | tee -a "$LOG_FILE"
}

cleanup() {
    log_message "开始清理。"
    if [ -n "${TEMP_DIR:-}" ] && [ -d "$TEMP_DIR" ]; then
        rm -rf "$TEMP_DIR"
        log_message "已删除临时目录：$TEMP_DIR"
    fi
}

# --- 退出和信号的陷阱 ---
trap 'cleanup' EXIT
trap 'log_message "脚本被中断（SIGINT）。退出。"; exit 130' INT
trap 'log_message "脚本被终止（SIGTERM）。退出。"; exit 143' TERM

# --- 主脚本逻辑 ---
log_message "开始配置备份。"

# 1. 检查源目录是否存在
if [ ! -d "$BACKUP_SOURCE" ]; then
    log_message "错误：备份源 '$BACKUP_SOURCE' 不存在。" >&2
    exit 2 # 无效源的自定义错误码
fi

# 2. 确保备份目标存在
mkdir -p "$BACKUP_DEST" || {
    log_message "错误：无法创建/确保备份目标 '$BACKUP_DEST' 存在。" >&2
    exit 3 # 目标问题的自定义错误码
}

# 3. 创建用于压缩的临时目录
TEMP_DIR=$(mktemp -d)
log_message "已创建临时目录：$TEMP_DIR"

# 4. 将数据复制到临时目录
cp -r "$BACKUP_SOURCE" "$TEMP_DIR/" || {
    log_message "错误：无法将数据从 '$BACKUP_SOURCE' 复制到 '$TEMP_DIR'。" >&2
    exit 4 # 复制失败的自定义错误码
}
log_message "数据已复制到临时位置。"

# 5. 压缩数据
ARCHIVE_NAME="config_backup_${TIMESTAMP}.tar.gz"
tar -czf "$TEMP_DIR/$ARCHIVE_NAME" -C "$TEMP_DIR" "$(basename "$BACKUP_SOURCE")" || {
    log_message "错误：无法压缩数据。" >&2
    exit 5 # 压缩失败的自定义错误码
}
log_message "数据已压缩为 $ARCHIVE_NAME。"

# 6. 将归档文件移动到最终目标
mv "$TEMP_DIR/$ARCHIVE_NAME" "$BACKUP_DEST/" || {
    log_message "错误：无法将归档文件移动到 '$BACKUP_DEST'。" >&2
    exit 6 # 移动失败的自定义错误码
}
log_message "归档文件已移动到 '$BACKUP_DEST/$ARCHIVE_NAME'。"

log_message "备份成功完成！"
exit 0

要点

将退出码视为脚本接口的一部分。检查关键命令，在失败时返回清晰的非零状态，并记录任何其他脚本或 CI 作业可能需要解释的自定义代码。

Bash 脚本编程：深入理解退出码与状态

理解退出码

获取最后一条命令的退出码：$?

使用 exit 显式设置退出码