如何在 Node.js 中实现带箭头导航的交互式选项选择（类似下拉菜单）

本文介绍使用 inquirer.js 的 `@inquirer/select` 包，在命令行中创建支持键盘方向键导航、回车确认的交互式单选菜单，无需 gui，纯终端友好。

在 Node.js 命令行工具开发中，若需提供直观、易操作的用户选项界面（如“请选择颜色：? 红 / ? 绿 / ? 蓝”），并支持 上下箭头键切换高亮项、Enter 键确认选择，原生 readline 模块虽可实现，但需手动处理按键事件、光标渲染与状态管理，复杂且易出错。推荐采用成熟、轻量、维护活跃的交互式提示库——其中 @inquirer/select 是当前最佳实践之一。

✅ 快速上手：三步实现箭头导航选择器

1. 安装依赖

   npm install @inquirer/select

2. 编写交互逻辑（ESM 格式）
   创建 select-color.js：

   import select from '@inquirer/select';
   
   async function run() 
   {
     const answer = await select({
       message: 'Pick a color:',
       choices: [
         { name: 'Red', value: 'red' },
         { name: 'Green', value: 'green' },
         { name: 'Blue', value: 'blue' }
       ]
     });
   
     console.log(`✅ You selected: ${answer}`);
   }
   
   run();

3. 确保模块支持
   若运行时报错 SyntaxError: Cannot use import statement outside a module，请在项目根目录 package.json 中添加：

   {
     "type": "module"
   }

   或改用 CommonJS（CJS）写法（需安装 cjs 兼容版本，但推荐统一使用 ESM）。

? 进阶特性（提升用户体验）

• 自定义显示名与值分离：name 用于终端展示（如 'Red'），value 为程序内部使用的实际值（如 'red'），避免硬编码字符串。
• 默认选项：添加 default: 'green' 属性，启动时自动高亮绿色项。
• 禁用选项/分组标题：支持 disabled: true 或 type: 'separator' 实现更复杂的菜单结构。
• 响应式退出：用户按 Ctrl+C 会抛出 AbortError，可捕获处理：

  try {
    const answer = await select({ /* ... */ });
    console.log(`Selected: ${answer}`);
  } catch (err) {
    if (err.name === 'AbortError') {
      console.log('❌ User cancelled.');
      process.exit(0);
    }
  }

⚠️ 注意事项

• @inquirer/select 仅适用于 Node.js 环境（v16.14+ 推荐），不兼容浏览器；
• 终端需支持 ANSI 转义序列（绝大多数现代终端均支持），Windows PowerShell / Git Bash / macOS Terminal / Linux TTY 均可正常工作；
• 避免在非交互环境（如 CI/CD 流水线、Docker 容器无 TTY）中调用，否则会挂起；可通过 process.stdin.isTTY 提前校验；
• 如需多选、模糊搜索、动态加载选项等高级功能，可搭配 @inquirer/multiselect 或 @inquirer/search 等同生态包。

通过 @inquirer/select，你能在几行代码内交付专业级 CLI 交互体验——简洁、可靠、符合用户直觉。告别手动监听 keypress，专注业务逻辑本身。