timeout命令需配合-k强制杀招、--foreground防逃逸，并显式判断退出码124以区分超时与失败；在systemd或cron中须补全path及绝对路径，管道调用须整体包裹。

直接用 timeout 命令包裹调用即可，关键是选对信号、加强制杀招、显式判码——不是加个时间参数就完事。

核心操作：用 -k 强制兜底 + --foreground 防逃逸

不稳定二进制（比如某个老版本的 ffmpeg、pdf2text 或私有 CLI 工具）常会忽略 SIGTERM、fork 出子进程脱离控制，或卡在系统调用里不动。默认 timeout 30s ./unstable-bin 很可能失效。

• 加 --foreground：防止它因新建会话而脱离 timeout 的进程组，确保子进程也被纳入管控
• 必须加 -k 3s（或更短）：先发 SIGTERM，3 秒后不管是否响应，立刻发 SIGKILL 强杀
• 完整写法示例：
  timeout --foreground -k 3s 30s ./unstable-bin -i input.pdf -o output.txt

退出码必须显式判断，不能靠 && 或 if 直接分支

超时返回 124，命令失败可能返回 1、2、127 等，混在一起会导致误判。生产脚本里务必解构 $?：

Linux installer

先解析安全源，运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

• timeout --foreground -k 2s 20s ./my-tool --run
• case $? in
•   0) echo "success";;
•   124) echo "KILLED: timeout after 20s" >&2; exit 1;;
•   127) echo "ERROR: binary not found or permission denied" >&2; exit 1;;
•   *) echo "FAILED: exit code $?" >&2; exit 1;;
• esac

在 systemd service 或 cron 中要补环境短板

交互终端能跑通，放到后台服务里常静默失败——根本原因是 PATH 缺失、无 TTY、或缺少依赖库路径。

• systemd service 中：显式设置 Environment=PATH=/usr/local/bin:/usr/bin:/bin，并加 StandardOutput=journal 方便查日志
• cron 任务中：所有路径写绝对路径，例如 /usr/bin/timeout -k 5s 60s /opt/vendor/tool --flag
• 若工具内部调用了 ssh、sudo、docker 等需 TTY 的命令，加 -t 参数（如 ssh -t）或用 script -qec 包一层

管道和复杂调用必须整体包裹

别只给第一个命令套 timeout，否则后续命令照常运行：

• ❌ 错误：timeout 10s cat input.json | ./unstable-parser → 只杀 cat，parser 继续跑
• ✅ 正确：timeout --foreground -k 2s 10s sh -c 'cat input.json | ./unstable-parser > output.json'
• 如果涉及重定向、变量展开或环境设置，统一放进 sh -c 字符串里，避免 shell 解析阶段逃逸