Bash return 的八位状态：明明返回 256，为什么 if 却进入成功分支
把函数里算出的数量写成return 256，调用后if却认为成功，问号参数也只剩零。Bash的return传递的是命令退出状态，不是任意范围的数值结果。给它一个整数以后，调用者看到的是最低八位，原来的完整数字已经不能从状态中恢复。
完整程序仅使用Bash内建命令，已在GNU Bash 5.2.37实跑。保存为demo.sh，用bash demo.sh执行，不要交给sh。样本只有五个固定整数和一个固定计数输出，不创建文件、不调用外部服务，也不依赖set -e完成错误控制。
AI模型生成概念图：有限刻度装置只送出一个状态块，旁边独立通道保留完整数据堆，用于区分状态与结果；图中块数不是二进制位图。
完整实验程序
status_only只执行return，调用方立刻保存状态。第二段count_records把三百写到标准输出并用零报告成功，两条通道因此可以被分别观察和验证。
完整可运行程序
#!/usr/bin/env bash
set -u
status_only() {
return "$1"
}
for requested in 0 255 256 257 -1; do
if status_only "$requested"; then
received=0
else
received=$?
fi
expected=$(( requested & 255 ))
[[ $received -eq $expected ]] || exit 1
printf 'return %s -> status %s\n' "$requested" "$received"
done
count_records() {
printf '%s\n' 300
return 0
}
if value=$(count_records); then
received=0
else
received=$?
exit "$received"
fi
[[ $value == 300 && $received -eq 0 ]] || exit 2
printf 'data=%s status=%s\n' "$value" "$received"本次实际输出
return 0 -> status 0 return 255 -> status 255 return 256 -> status 0 return 257 -> status 1 return -1 -> status 255 data=300 status=0
越过255以后，状态会折回较小数值
前五行依次得到零、255、零、一、255。return 256的最低八位全为零，所以if进入成功分支；return 257留下的一，则使if进入失败分支。数字大一点，并不代表调用者会收到更大的错误码。
负一也得到255。示例用按位与255计算固定样本的预期状态，是为了把规则变成断言，并不是建议把业务结果主动压成八位。五种输入同时测试，比只选二或三这样的短小错误码，更容易发现有人误把return当作数值返回接口。
零是成功约定，不是完整结果的证明
如果函数想报告扫描到256条记录，return 256既丢了计数，又会让调用方按成功状态继续。若函数想报告某个自定义错误编号256，同样会误变成成功。错误类别与数据数量应该在接口设计时分开，不能等状态溢出后才解释。
这里的结论针对Bash return。其他工具可能对自己的退出码另有约定，例如某个非零状态只是没有匹配项。调用方应遵循具体命令协议，不能把任何非零数字都直接解释成同一种故障，更不要把可能有大范围取值的数据装进状态。
让标准输出带数据，让状态说明是否完成
最后一行data=300 status=0保留了完整计数。命令替换收集count_records的标准输出，if检查该次调用的完成状态；成功后才验证value恰好是预期文字三百。这样即使结果为零条记录，也能与运行失败分别表达。
如果函数还需要诊断日志，应把日志送到标准错误，保持标准输出符合约定的数据格式。否则一句调试提示也会被value收进去。复杂多字段结果还需要定义分隔与解析规则，而不是把几段文字随意拼在一起。
保存状态也有时机要求
失败分支的第一句就是received=$?，保存以后才做其他操作。若先打印提示，问号参数可能已经变成printf的状态。这里在成功分支显式写零，避免把后续命令的状态误归给被测函数。
return不写参数时采用之前命令的状态，也容易受新增日志影响。对于一个明确的结果生产函数，完成后显式return 0、失败时使用约定的非零状态，通常更便于审查。状态代表任务阶段是否按协议完成，数据内容还需要单独验收。
命令替换会移除输出末尾的换行；本例只传一个十进制计数，所以这个行为符合需要。若传输二进制内容或必须保留的尾部空行，应选择能够保持这些边界的通道，而不能把这里的计数模板推广为任意数据接口。
参考资料
官方资料核验日期：2026年10月2日。上述输出来自本文完整程序的本地执行，断言全部通过，退出状态为零。
