Inquirer.js 中优雅处理 Ctrl+C 中断的技巧

前言

在使用 Node.js 开发命令行工具时，Inquirer.js 是一个非常流行的交互式命令行界面库。然而，许多开发者在处理用户通过 Ctrl+C 中断操作时，会遇到错误信息显示不友好的问题。本文将深入探讨如何优雅地处理这类中断场景。

问题现象

当用户在 Inquirer.js 的交互过程中按下 Ctrl+C 时，默认会抛出 ExitPromptError 错误，导致控制台显示类似以下的堆栈信息：

ExitPromptError: User force closed the prompt with 0 null
    at file://.../create-prompt.mjs:30:28

这种错误显示不仅不友好，还会让终端用户感到困惑。

解决方案

基础方案：try/catch 捕获

最直接的解决方案是使用 try/catch 块来捕获错误：

try {
    const answer = await inquirer.prompt(questions);
} catch (error) {
    if (error.name === 'ExitPromptError') {
        // 处理用户中断逻辑
    }
}

进阶方案：全局错误处理

对于包含多个交互步骤的复杂命令行工具，可以在程序入口处设置全局错误处理器：

process.on('uncaughtException', (error) => {
    if (error instanceof Error && error.name === 'ExitPromptError') {
        // 静默处理中断错误
        process.exit(0);
    } else {
        // 其他错误正常抛出
        throw error;
    }
});

这种方法的好处是：

1. 避免在每个交互点都添加错误处理代码
2. 保持代码整洁
3. 统一处理所有可能的交互中断

最佳实践建议

1. 资源清理：在退出前确保释放所有资源（如数据库连接、文件句柄等）
2. 退出码选择：根据场景选择适当的退出码（0表示正常退出，非0表示错误）
3. 用户反馈：可以提供简洁的退出信息，如"操作已取消"
4. 错误日志：对于非中断错误，建议记录详细日志

实现原理

Inquirer.js 内部使用 process 事件监听器来捕获 SIGINT 信号（Ctrl+C）。当检测到中断时，它会拒绝当前 Promise 并抛出 ExitPromptError。理解这一机制有助于我们更好地处理各种边界情况。

总结

优雅处理用户中断是开发高质量命令行工具的重要环节。通过合理的错误捕获和处理机制，可以显著提升用户体验。Inquirer.js 提供的灵活接口允许开发者根据具体需求选择最适合的处理方式，无论是局部捕获还是全局处理都能很好地实现。