命令行与文本处理 / 系统课时
函数怎样返回成功或失败
函数怎样返回成功或失败
Shell 函数不仅能封装命令,还能用退出状态告诉调用方“这一步是否成功”。掌握 return 后,就能让备份、校验、批处理等步骤在失败时停止,在成功时继续,而不必依赖函数输出的文字判断结果。
学习目标
- 使用
return为函数设置成功或失败状态 - 使用
if根据函数退出状态决定后续流程 - 区分函数的标准输出与退出状态
return 返回的是退出状态
在 Bash 中,函数执行后会产生一个整数退出状态。约定上,0 表示成功,非 0 表示失败。函数可以使用 return 主动设置这个状态。
check_readable_file() {
local file="$1"
if [[ -f "$file" && -r "$file" ]]; then
return 0
fi
return 1
}这里的 return 0 并不是把数字 0 当作业务数据返回,而是在告诉调用方:检查成功。return 1 则表示检查失败。
如果函数没有显式执行 return,函数的退出状态通常就是最后一条实际执行命令的退出状态。为了让脚本结构更明确,承担判断职责的函数通常值得显式写出成功和失败分支。
让调用方根据状态分支
下面的脚本创建一个临时文件,分别检查存在的文件和不存在的文件。if 会直接根据函数的退出状态选择分支,因此不必先读取 $?。
#!/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预期输出
文件检查成功,继续处理
文件检查失败,停止处理这种写法很适合自动化脚本:函数只负责完成一项工作并报告成败,主流程负责决定成功后继续执行什么、失败后采取什么措施。
需要读取状态时立即保存
有时调用方需要记录具体退出状态,可以在函数调用后立即读取 $?。$? 只保存上一条命令的状态,执行其他命令后就会被覆盖。
check_readable_file "$tmp_file"
status=$?
printf 'status=%d\n' "$status"预期输出
status=0如果只是判断成功还是失败,优先使用 if function_name; then ...,比先保存 $? 再比较更直接,也更不容易因为插入其他命令而取错状态。
不要把 echo 当作 return
echo、printf 等命令写入的是标准输出,可以被命令替换捕获;return 设置的是函数退出状态,两者用途不同。函数既可以输出数据,也可以返回成功或失败,但调用方应明确自己需要的是哪一种结果。
Bash 的退出状态实际落在 0~255 范围内,因此不要设计过大的自定义状态码。自动化脚本通常使用少量稳定状态即可,例如 0 表示成功,1 表示一般失败,其他非零值只在确实需要区分失败原因时使用。