用printf "\r"可实现原地覆盖倒计时，原理是回车符\r将光标移至行首，新输出覆盖旧内容；配合sleep控制节奏、-t 1判断终端、trap捕获中断，确保兼容性与健壮性。
用 printf + \r 覆盖重写同一行实现基础倒计时
Shell 本身没有内置进度条函数，但靠 printf 的回车控制（\r）就能在终端原地刷新——关键不是换行，而是「回到行首再输出」。配合 sleep 控制节奏，就能做出视觉连续的倒计时效果。
常见错误是误用 \n，结果每秒打一行，变成滚动日志而非进度条；还有人直接用 echo，但不同系统下 echo -e 行为不一致，printf 更可靠。
- 用
printf "\r%ds left..." $sec，\r让光标回到行首，新内容覆盖旧内容 - 结尾必须跟
printf "\n"或echo换行，否则下次命令提示符会挤在进度条后面 - 倒计时循环里别漏掉
sleep 1，否则 CPU 疯转且看不到变化
sec=5 while [ $sec -ge 0 ]; do printf "\r%d seconds left..." $sec sleep 1 sec=$((sec - 1)) done printf "\n"
加 ASCII 进度条：用 seq 和字符串拼接动态生成填充段
纯数字倒计时不够直观，加个类似 [====> ] 的图形化进度条能提升可读性。核心思路是把总时长映射成固定长度的字符序列（比如 20 格），每过一秒就多画一个 =，最后用 > 表示当前点。
注意：Shell 字符串截取和循环生成不如高级语言方便，别硬写复杂逻辑；用 printf "%*s" $len "" | tr " " "=" 这类技巧虽可行，但易出错，更稳妥的是预生成空格/等号串再替换。
- 总长度设为
bar_len=20，当前已过秒数done=$((total_sec - remaining)) - 已完成格数：
filled=$((done * bar_len / total_sec))，整除避免小数 - 用
printf "%-${bar_len}s" "$(printf "%${filled}s" | tr " " "=")"快速生成等号串 -
\r输出时确保整行宽度一致，否则残留字符会干扰显示
兼容性陷阱：printf 的 \r 在非交互式环境可能失效
在管道中执行、重定向到文件、或通过 ssh 远程调用时，\r 往往被忽略或转义，导致进度条变成多行乱码。这不是代码写错了，而是终端能力缺失。
判断方式：运行 if [ -t 1 ]; then echo "tty"; fi，仅当 stdout 是终端（tty）时才启用 \r 刷新。否则退化为纯文字倒计时，或干脆跳过视觉更新。
- 脚本开头加判断：
if [ -t 1 ]; then use_carriage_return=true; else use_carriage_return=false; fi - 输出逻辑分支：
$use_carriage_return && printf "\r%s" "$msg" || printf "%s\n" "$msg" - CI/CD 环境（如 GitHub Actions）默认无 tty，强行用
\r会导致日志解析失败
真正难的是中断响应与资源清理
用户按 Ctrl+C 时，进度条常卡在中间状态，光标位置错乱，甚至后续命令提示符被吞掉。这不是视觉问题，而是信号处理没做。
Shell 的 trap 能捕获 INT 信号，但要注意：倒计时循环中 sleep 是阻塞点，Ctrl+C 会中断它并触发 trap，此时必须确保退出前重置终端状态。
- 用
trap 'printf "\n"; exit 130' INT，强制换行再退出，避免提示符粘连 - 不要在 trap 里调用复杂命令（如
clear），某些最小化环境不含这些工具 - 如果倒计时需配合后台任务（如
curl下载），得用wait+kill配合 PID，否则子进程可能继续跑
实际写的时候，最易忽略的是 tty 判断和中断清理——功能跑通了，一放到自动化流程里就崩，问题往往出在这两处。
