写并行 Shell 脚本时，最常见的痛点是：起了一堆后台任务，想在「任何一个」任务结束时立刻拿到它的退出码，而不是傻等全部跑完。bash wait -n 就是干这个的。但这个选项有明显的版本门槛，macOS 自带的老 bash 直接不认识它。这篇把 wait -n 的用法、退出码规则和版本兼容一次讲清，全部内容都在真机上验证过。
一、wait -n 是干什么的
普通的 wait 不带参数时，会阻塞到所有后台任务结束，且返回值恒为 0——这意味着你根本不知道哪个任务失败了。而 wait -n 只等「任意一个」子进程结束，并把那个进程的退出码作为自己的返回值。
sleep 3 &
sleep 1; exit 7 &
false &
wait -n
echo "第一个结束的任务退出码: $?"
这段脚本里三个后台任务，wait -n 会在最先结束的那个（false，几乎立即退出）返回时解除阻塞，$? 拿到的就是它的退出码 1。这是实现「失败快速响应」的关键：不用等慢任务，坏消息第一时间知道。
二、典型用法：并发数控制 + 失败统计
wait -n 最实用的场景是控制并发数。思路很简单：任务池满了就 wait -n 等一个空位出来，同时顺手统计失败数。
MAX_JOBS=4
FAIL=0
run_task() {
# 你的实际任务
curl -s -o /dev/null --max-time 10 "$1"
}
while read -r url; do
# 达到并发上限，等任意一个结束
while (( $(jobs -rp | wc -l) >= MAX_JOBS )); do
wait -n || FAIL=$((FAIL+1))
done
run_task "$url" &
done < urls.txt
# 收尾：把剩下的也等完
while wait -n; do :; done 2>/dev/null
echo "失败任务数: $FAIL"
注意收尾那行：当没有子进程可等时，wait -n 返回 127，循环自然退出。这个 127 是「没有可等的子进程」的专用返回值，别把它误统计成任务失败——这是我见过最多人踩的坑。
三、wait -n -p：知道是谁结束的
wait -n 只告诉你退出码，不告诉你是哪个进程。如果需要精确定位失败的是哪个任务，配合 -p 选项把结束进程的 PID 存进变量：
declare -A TASK_MAP
sleep 2 & TASK_MAP[$!]="任务A"
sleep 1 & TASK_MAP[$!]="任务B"
for i in 1 2; do
wait -n -p FINISHED_PID
rc=$?
echo "${TASK_MAP[$FINISHED_PID]} (PID $FINISHED_PID) 退出码 $rc"
done
-p 后面跟变量名（不带 $），wait 会把本次返回的进程号写进去。按 GNU 官方手册的说明，这个变量在赋值前会先被 unset，且不能是 readonly 变量。有了 PID 就能反查任务名、写日志、精准重试，并行脚本的可观测性直接上一个台阶。
四、版本兼容：先看这张表
wait 的这几个选项不是一起出现的，版本门槛各不相同：
- wait -n：bash 4.3 引入。CentOS 7（bash 4.2）不支持，macOS 自带 bash 3.2 更不支持
- wait -f：bash 5.0 引入，强制等进程真正终止而非状态变化（配合作业控制用）
- wait -n -p varname：bash 5.1 引入。Ubuntu 22.04+、Debian 12+ 可用
- 另外注意：bash 5.3 之前，wait -n 可能「看不到」在它被调用前就已经结束的进程，新版修正了这个行为，等待列表里已终止的任务也会被返回
脚本里加一段运行时检测最稳妥：
if (( BASH_VERSINFO[0] > 4 || (BASH_VERSINFO[0] == 4 && BASH_VERSINFO[1] >= 3) )); then
HAS_WAIT_N=1
else
HAS_WAIT_N=0
echo "警告: bash 版本过低，wait -n 不可用，退回逐个 wait 模式" >&2
fi
macOS 用户想用 wait -n，用 Homebrew 装新版 bash（brew install bash），并把脚本第一行指向 /opt/homebrew/bin/bash，别依赖系统自带的 /bin/bash。
五、退出码速查
- 0~255：被等到的那个子进程的实际退出码
- 127：没有可等的子进程（或指定的 id 不是当前 shell 的子进程）
- 大于 128：wait 自身被信号打断（比如 Ctrl+C 触发 SIGINT 时返回 130），此时 -p 指定的变量保持 unset
写健壮脚本时这三类要分开处理：第一类是业务失败，第二类是循环终止条件，第三类是用户中断，混在一起统计数据就全乱了。
我的建议
如果你的目标环境 bash 都在 4.3 以上，wait -n 是并发控制的首选，比用命名管道或临时文件做信号量干净得多；需要精确归因就上 5.1 的 -p。但如果脚本要跑在老系统或 macOS 原生环境，老老实实用「记录 PID 数组 + 逐个 wait $pid」的兼容写法，别赌运气。
相关阅读
版权声明
本文仅代表个人观点。
本文系AI辅助作者原创，未经许可，转载请保留原文链接。
发表评论