现已发布!阅读 10 月份的新功能和修复。

通知

通知 显示来自 VS Code 右下角的简要信息。

Example of a notification

您可以发送三种类型的通知

为了尊重用户的注意力,请限制发送的通知数量。为了帮助您决定是否应该显示通知,请遵循我们的通知决策树

Show a multi-step quick pick if multi step user input is immediately needed. If user input is immediately needed but it is not multi-step show a modal dialog. If you need to show progress that is low priority show the progress in the status bar. If the interaction is triggered by the user find the right moment to show the notification and only then show it. If you need to show multiple notifications try to combine them into one. If the user does not really need to be notified consider to not show anything and relax.

通知示例

Information notification

此通知在用户运行**更新版本**命令后出现。请注意,没有额外的操作,纯粹是信息性的。

Warning notification

此示例突出显示了需要用户输入的功能问题,并显示了解决问题的操作。

Error notification

此示例显示了一个失败通知,其中包含一个操作来解决问题。

✔️ 要执行的操作

  • 仅在绝对必要时发送通知,以尊重用户的注意力
  • 为每个通知添加一个**不再显示**选项
  • 一次只显示一个通知

❌ 不要执行的操作

  • 发送重复的通知
  • 用于促销
  • 在首次安装时征求反馈
  • 如果没有操作,则显示操作

进度通知

当需要显示进度以进行不确定的时间段(例如,设置环境)时,可以使用进度通知。这种类型的全局进度通知应该作为最后的手段使用,因为进度最好保持在上下文中(在视图或编辑器中)。

✔️ 要执行的操作

  • 显示一个链接以查看更多详细信息(如日志)
  • 在设置过程中显示信息(初始化、构建等)
  • 提供一个操作来取消操作(如果适用)
  • 为超时情况添加计时器

❌ 不要执行的操作

  • 在进度中保留运行的通知

Progress notification

此示例使用进度通知来显示远程连接设置所涉及的设置,同时还提供指向输出日志(**详细信息**)的链接。