VSCode扩展API showInputBox的ignoreFocusOut属性失效及续问

一、ignoreFocusOut 属性的行为解析 #

• 你对属性的理解存在平台特定的偏差，并非功能故障：VSCode 文档中提及的“其他窗口”，在 macOS 平台实际仅指向 VSCode 内部的子窗口/编辑器区域（比如分栏编辑窗口、侧边栏等），而非系统级的其他应用窗口。当切换到 macOS 系统内的外部应用窗口时，即便设置 ignoreFocusOut: true，输入框仍会关闭，这是 macOS 窗口管理机制导致的平台特定行为。
• 验证方式：可测试在 VSCode 内部切换焦点（如点击编辑器其他区域、侧边栏），此时输入框会保持打开，符合文档描述；但切换到浏览器、终端等外部应用则会触发关闭。

二、多步骤命令恢复方案 #

针对5步骤流程的中断恢复需求，可通过以下方式实现：

1. 借助 shouldResume 回调恢复状态
   当命令因输入框关闭中断后，用户重新触发命令时会调用 shouldResume 函数，可在该回调中恢复之前保存的步骤和输入状态。
2. 用全局存储持久化流程状态
   使用 VSCode 扩展的 ExtensionContext.globalState 保存当前步骤编号、已输入内容等信息，示例调整如下：

// 假设已获取 extensionContext
async function runMultiStepFlow(context) {
  // 初始化或恢复流程状态
  let currentStep = context.globalState.get('currentStep', 1);
  let state = {
    url: context.globalState.get('url', ''),
    // 其他步骤对应的状态字段
  };

  const shouldResume = () => {
    // 从全局存储恢复状态
    currentStep = context.globalState.get('currentStep', 1);
    state.url = context.globalState.get('url', '');
    return Promise.resolve(true);
  };

  while (currentStep <= this.maxSteps) {
    switch(currentStep) {
      case 1:
        state.url = await input.showInputBox({
          ignoreFocusOut: true,
          title: this.title,
          step: currentStep,
          totalSteps: this.maxSteps,
          value: state.url,
          prompt: "Enter remote Git URL",
          validate: this.validateProtocol,
          shouldResume: shouldResume,
        });
        if (!state.url) break; // 处理用户取消的情况
        // 保存当前步骤和状态到全局存储
        await context.globalState.update('currentStep', 2);
        await context.globalState.update('url', state.url);
        currentStep++;
        break;
      // 步骤2-5的处理逻辑参照步骤1，完成后更新对应状态和步骤编号
      case 2:
        // ... 步骤2的交互逻辑
        break;
      // ... 后续步骤
    }
  }

  // 流程正常完成后，清空全局存储的状态
  await context.globalState.update('currentStep', undefined);
  await context.globalState.update('url', undefined);
}

3. 关键注意事项
   • 每完成一个步骤，务必将当前步骤编号和对应状态保存到 globalState；
   • 在 shouldResume 回调中从 globalState 读取状态，确保重新触发命令时能从中断处继续；
   • 流程完成或用户主动取消时，清空存储的状态，避免下次触发命令加载旧数据。

内容的提问来源于stack exchange，提问作者Michael Sorens