命令行与文本处理 / 系统课时

函数怎样返回成功或失败

函数怎样返回成功或失败

Shell 函数不仅能封装命令,还能用退出状态告诉调用方“这一步是否成功”。掌握 return 后,就能让备份、校验、批处理等步骤在失败时停止,在成功时继续,而不必依赖函数输出的文字判断结果。

学习目标

  • 使用 return 为函数设置成功或失败状态
  • 使用 if 根据函数退出状态决定后续流程
  • 区分函数的标准输出与退出状态

return 返回的是退出状态

在 Bash 中,函数执行后会产生一个整数退出状态。约定上,0 表示成功,非 0 表示失败。函数可以使用 return 主动设置这个状态。

bash
check_readable_file() {
  local file="$1"

  if [[ -f "$file" && -r "$file" ]]; then
    return 0
  fi

  return 1
}

这里的 return 0 并不是把数字 0 当作业务数据返回,而是在告诉调用方:检查成功。return 1 则表示检查失败。

如果函数没有显式执行 return,函数的退出状态通常就是最后一条实际执行命令的退出状态。为了让脚本结构更明确,承担判断职责的函数通常值得显式写出成功和失败分支。

让调用方根据状态分支

下面的脚本创建一个临时文件,分别检查存在的文件和不存在的文件。if 会直接根据函数的退出状态选择分支,因此不必先读取 $?。

bash
#!/usr/bin/env bash

check_readable_file() {
  local file="$1"

  if [[ -f "$file" && -r "$file" ]]; then
    return 0
  fi

  return 1
}

tmp_file=$(mktemp)
trap 'rm -f "$tmp_file"' EXIT

if check_readable_file "$tmp_file"; then
  echo "文件检查成功,继续处理"
else
  echo "文件检查失败,停止处理"
fi

if check_readable_file "${tmp_file}.missing"; then
  echo "文件检查成功,继续处理"
else
  echo "文件检查失败,停止处理"
fi

预期输出

text
文件检查成功,继续处理
文件检查失败,停止处理

这种写法很适合自动化脚本:函数只负责完成一项工作并报告成败,主流程负责决定成功后继续执行什么、失败后采取什么措施。

需要读取状态时立即保存

有时调用方需要记录具体退出状态,可以在函数调用后立即读取 $?。$? 只保存上一条命令的状态,执行其他命令后就会被覆盖。

bash
check_readable_file "$tmp_file"
status=$?
printf 'status=%d\n' "$status"

预期输出

text
status=0

如果只是判断成功还是失败,优先使用 if function_name; then ...,比先保存 $? 再比较更直接,也更不容易因为插入其他命令而取错状态。

不要把 echo 当作 return

echo、printf 等命令写入的是标准输出,可以被命令替换捕获;return 设置的是函数退出状态,两者用途不同。函数既可以输出数据,也可以返回成功或失败,但调用方应明确自己需要的是哪一种结果。

Bash 的退出状态实际落在 0~255 范围内,因此不要设计过大的自定义状态码。自动化脚本通常使用少量稳定状态即可,例如 0 表示成功,1 表示一般失败,其他非零值只在确实需要区分失败原因时使用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

函数怎样返回成功或失败

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通