Linux 退出码（Exit Code）是脚本执行结果的数字信号，0 代表成功，非 0 代表失败，它是自动化运维和错误排查的核心依据。
在 Linux 系统中，每一个命令、脚本或程序结束时，都会向父进程返回一个整数，这就是退出码，它就像是一个无声的信号灯，告诉系统刚才的操作是绿灯放行还是红灯停摆，对于日常使用者来说，这可能只是一个瞬间闪过的数字；但对于运维工程师和开发者而言，它是诊断系统健康状态的第一手资料，理解并善用退出码，能极大提升故障排查的效率，避免在复杂的日志海洋中盲目打捞。
![[Error]Id return 1exit status一直报错，求大佬解答](https://i0.hdslb.com/bfs/archive/838e74abae2aa15329634221da0f21534843ee87.jpg)
退出码的基础逻辑与常见数值解析
退出码的本质是一个 8 位无符号整数，取值范围在 0 到 255 之间，虽然理论上可以返回任意值，但行业共识认为，保留前 256 个值作为标准定义，其余高位通常保留给特定应用或内核错误。
零与非零的核心区别
成功状态：退出码 0
当命令执行完毕且未发生任何错误时，系统会返回 0，这并不意味着命令产生了“有意义”的输出，仅表示流程正常结束，创建一个空文件 `touch test.txt`，即使文件内容为空，只要文件创建成功，其退出码即为 0。
失败状态：退出码 1-255
非零值代表某种形式的失败，虽然不同的数字代表不同的错误类型，但在大多数通用场景下，非零值本身就足以触发错误处理机制，尝试访问一个不存在的文件，或者权限不足，都会返回非零值。
关键退出码速查表
为了快速定位问题,以下是 Linux 中最高频出现的几个退出码及其含义：
| 退出码 | 含义 | 常见场景示例 |
|---|---|---|
| 0 | 成功 | 命令正常执行完毕 |
|
1 | 通用错误 | 脚本逻辑错误，或命令未找到 |
| 2 | 误用 Shell 内置命令 | 通常由 bash 内部机制触发 |
| 126 | 命令不可执行 | 文件存在但没有执行权限 |
| 127 | 命令未找到 | 输入的命令不在 PATH 环境变量中 |
| 128+n | 致命错误信号 n | 进程被信号终止，如 137 (SIGKILL) |
业内专家指出,理解信号相关的退出码（128+）对于排查进程突然消失的问题至关重要，当服务器内存不足时，OOM Killer 会发送 SIGKILL 信号（编号 9），导致进程退出码变为 137。
如何在 Bash 脚本中获取与判断退出码
在实际操作中,获取退出码是编写健壮脚本的第一步，Linux 提供了一个特殊的变量 来存储最近一条命令的退出码。
获取退出码的标准方法
获取 必须紧跟在目标命令之后，一旦执行下一条命令， 的值就会被覆盖，最佳实践是立即将其赋值给一个变量，或在条件判断中直接使用。
# 错误示例：中间插入了 echo 命令，导致 $? 丢失 ls /nonexistent echo $? # 这里输出的是 echo 命令的退出码 0，而非 ls 的结果 # 正确示例：立即捕获 ls /nonexistent exit_code=$? echo "Last command exit code: $exit_code"
条件判断中的实战应用
在脚本中,我们通常结合 if 语句来处理不同的退出码，这种模式在自动化部署和备份脚本中极为常见。
#!/bin/bash
# 尝试复制文件
cp source.txt /backup/
# 检查退出码
if [ $? -eq 0 ]; then
echo "备份成功"
else
echo "备份失败，请检查权限或磁盘空间"
exit 1
fi
这种写法虽然直观,但在复杂脚本中略显冗长，更简洁的方式是利用逻辑运算符 && 和 。
# 成功时执行 A，失败时执行 B command && echo "Success" || echo "Failed"
多命令组合时的退出码陷阱
在使用管道 时， 返回的是最后一个命令的退出码，而非整个管道的结果，这意味着，如果管道前半部分失败而后半部分成功， 仍可能为 0。
# 假设 cat 命令失败，但 grep 可能因输入为空而返回非零，或反之 cat nonexistent.txt | grep "pattern" echo $?
若要检查整个管道的状态,需启用 set -o pipefail，该设置使得管道返回最后一个非零退出码，若全部成功则返回 0，这是编写高质量 Shell 脚本的行业标准做法。
高级场景：自定义退出码与异常处理
除了使用系统默认的错误码,开发者经常需要根据业务逻辑定义特定的退出码，以便下游系统或监控平台进行精细化告警。
定义业务语义的退出码
在复杂的微服务架构或 CI/CD 流水线中，简单的“成功/失败”二元论往往不够用，数据库连接超时和网络超时可能需要不同的处理策略。
# 自定义退出码定义
ERR_DB_TIMEOUT=10
ERR_NET_TIMEOUT=11
ERR_CONFIG_MISSING=12
# 模拟检查逻辑
check_database() {
if ! ping -c 1 db-host; then
return $ERR_DB_TIMEOUT
fi
return 0
}
check_database
status=$?
if [ $status -eq $ERR_DB_TIMEOUT ]; then
alert "Database connection timed out"
elif [ $status -ne 0 ]; then
alert "Unknown error occurred: $status"
fi
通过这种方式,监控工具可以根据具体的退出码触发不同等级的告警，从而减少误报和漏报。
避免退出码冲突的最佳实践
当你的脚本调用其他脚本或命令时,必须确保自定义的退出码不与系统或子命令的保留码冲突，据工信部相关技术规范建议，保留 1-255 中的高位数值（如 100-255）作为用户自定义空间，是一种较为安全的做法。
始终在脚本开头使用 set -e 可以确保脚本在任何命令失败时立即退出，避免错误累积，但需注意，set -e 在某些条件判断中可能表现异常，需结合 set -o pipefail 和 set -o nounset 共同使用，以构建健壮的异常处理机制。
常见问题解答：Linux exit code 实战指南
如何查看上一条命令的退出码？
直接在终端输入 `echo $?` 即可，该命令会输出最近执行命令的返回值，如果上一条命令是 `ls`，且目录存在，输出通常为 0；若目录不存在，则输出非零值（如 2 或 1）。
为什么我的脚本没有报错但退出了？
这通常是因为脚本中某处显式调用了 `exit` 命令，或者遇到了 `set -e` 触发的自动退出，建议检查脚本中是否有 `exit 0` 或 `exit 1` 等语句，并确认是否启用了严格模式，使用 `bash -x script.sh` 可以打印执行轨迹，帮助定位意外退出的节点。
退出码 127 和 126 有什么区别？
退出码 127 表示“命令未找到”，即系统在当前 PATH 环境变量中找不到该可执行文件，退出码 126 表示“命令找到但不可执行”，通常是因为文件缺少执行权限（chmod +x），输入一个不存在的命令会报 127，而尝试运行一个没有执行权限的脚本则会报 126。
掌握 Linux 退出码的机制，不仅是编写脚本的基础，更是构建高可用自动化系统的关键，从简单的 检查到复杂的管道错误处理，每一个细节都关乎系统的稳定性，在 2026 年的运维实践中，对退出码的精细化控制，依然是区分初级脚本编写者与资深系统工程师的重要分水岭。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/455973.html
