如何在VS Code扩展中实现Windows/macOS原生系统通知功能？

VS Code扩展运行在Node.js环境中，要调用Windows操作中心、macOS通知中心的原生通知，核心是借助Node.js的第三方库封装能力，无需手动对接底层系统API，以下是具体实现方案：

依赖准备 #

首先在你的扩展项目中安装node-notifier——这个库已经封装了跨平台的原生通知调用逻辑：

npm install node-notifier --save

分平台实现细节 #

Windows平台（ToastNotification） #

Windows下必须指定appID，否则通知会被标记为Node.js应用；设置自定义ID后，通知会在系统设置中显示你的扩展名称：

const notifier = require('node-notifier');
const path = require('path');

function sendWindowsToast(title, content) {
  notifier.notify({
    title: title,
    message: content,
    icon: path.join(__dirname, 'assets/icon.ico'), // 可选：自定义通知图标
    appID: 'com.yourteam.yourextensionid', // 必填：唯一标识你的扩展
    sound: true, // 开启提示音
    wait: false // 不等待用户点击
  });
}

macOS平台（NSUserNotification/UserNotifications） #

macOS 10.14+会自动适配UserNotifications框架，无需额外配置，直接调用即可：

const notifier = require('node-notifier');

function sendMacNotification(title, content) {
  notifier.notify({
    title: title,
    message: content,
    sound: 'Ping', // 可选：指定系统提示音（如'Basso'/'Blow'）
    wait: false
  });
}

跨平台统一封装 #

通过os.platform()判断当前系统，封装成通用调用函数：

const os = require('os');
const notifier = require('node-notifier');
const path = require('path');

function sendNativeNotification(title, content, context) {
  const baseOpts = { title, message: content, wait: false };
  const platform = os.platform();

  if (platform === 'win32') {
    notifier.notify({
      ...baseOpts,
      icon: context.asAbsolutePath('./assets/icon.ico'), // 用扩展上下文获取绝对路径
      appID: 'com.yourteam.yourextensionid',
      sound: true
    });
  } else if (platform === 'darwin') {
    notifier.notify({
      ...baseOpts,
      sound: 'Ping'
    });
  }
}

// 调用示例（在扩展激活函数中使用）
// sendNativeNotification('编译完成', '你的项目已成功构建！', context);

关键注意事项 #

• 权限授权：首次发送通知时，系统会弹出权限请求，需要用户允许你的扩展（或Node.js）发送通知。
• 资源路径：打包扩展时，必须用VS Code扩展API的context.asAbsolutePath()获取资源绝对路径，避免相对路径失效。
• 调试验证：在VS Code调试扩展时，通知会正常显示；打包后测试时，确保图标等资源被正确打包进扩展包。

内容的提问来源于stack exchange，提问作者3eif