Gum项目中的退出码优化：区分超时与用户中断

在命令行工具开发中，正确处理用户交互和超时场景是提升脚本健壮性的关键。Gum作为一个流行的交互式命令行工具，其退出码设计直接影响脚本的流程控制能力。本文将深入探讨Gum当前退出码机制的局限性，以及如何通过技术改进实现更精细化的流程控制。

当前机制的局限性

Gum目前对于两种常见的中断场景——用户主动终止（Ctrl+C）和操作超时（--timeout）——都返回相同的退出码130。这种设计虽然简化了实现，但给脚本编写者带来了困扰：

1. 无法区分被动超时和主动中断
2. 难以实现差异化的后续处理逻辑
3. 降低了脚本的容错能力

技术实现方案

要实现这两种场景的区分，可以考虑以下技术方案：

1. 差异化退出码：为超时场景分配新的退出码（如142），保留130用于用户中断
2. 信号处理优化：在超时触发时设置特定标志位，在退出前检查该标志
3. 上下文传递：通过临时文件或环境变量传递中断原因

实际应用价值

这种改进将为脚本编写带来显著优势：

• 自动化脚本：可以设置超时后的默认值，同时保留用户主动取消的能力
• 错误报告：能更精确地记录和报告中断原因
• 流程控制：实现更复杂的条件判断逻辑

实现建议

在具体实现上，建议：

1. 保持向后兼容，不影响现有脚本
2. 在文档中明确记录各退出码含义
3. 考虑添加--strict模式强制使用新退出码

这种改进虽然看似微小，但对提升命令行工具的可用性和脚本的健壮性具有重要意义。它体现了命令行工具设计中"显式优于隐式"的原则，使脚本行为更加可预测和可控制。