Electron开发中如何移除应用的Windows任务栏预览（非图标）

以下方案仅针对Windows平台生效，不会移除任务栏图标，完全匹配需求。 #

推荐实现方式（无额外依赖） #

直接使用Electron内置API即可实现，无需引入第三方包：

• 在主进程创建BrowserWindow实例后，添加Windows平台专属判断，调用setThumbnailClip方法设置预览区域为0大小，即可隐藏窗口内容预览：

const { BrowserWindow, app } = require('electron')

app.whenReady().then(() => {
  const mainWindow = new BrowserWindow({
    // 保留你的原有窗口配置项
    width: 1200,
    height: 800,
    webPreferences: {
      nodeIntegration: true,
      contextIsolation: false
    }
  })

  // Windows平台专属逻辑
  if (process.platform === 'win32') {
    // 设置任务栏预览区域为0，隐藏窗口内容预览
    mainWindow.setThumbnailClip({
      x: 0,
      y: 0,
      width: 0,
      height: 0
    })
  }

  mainWindow.loadFile('index.html')
})

进阶方案（强制仅显示图标预览） #

如果需要完全禁止系统生成窗口快照，仅显示应用图标，可以调用Windows原生DWM API实现：

1. 先安装依赖：npm install win32-api ref-napi ref-struct-napi
2. 添加如下代码：

if (process.platform === 'win32') {
  const { DwmSetWindowAttribute } = require('win32-api/apis/dwmapi')
  const DWMWA_FORCE_ICONIC_REPRESENTATION = 7

  const hWnd = mainWindow.getNativeWindowHandle()
  const enabled = Buffer.alloc(4)
  enabled.writeInt32LE(1, 0)
  DwmSetWindowAttribute(hWnd, DWMWA_FORCE_ICONIC_REPRESENTATION, enabled, 4)
}

注意事项 #

• 所有Windows专属逻辑不会影响Mac、Linux平台的应用表现
• 如果应用运行过程中会销毁重建窗口，每次创建完成后都需要重新调用对应方法，配置才会生效
• 可以配合mainWindow.setThumbnailToolTip('你的应用名称')使用，预览交互体验更一致

内容的提问来源于stack exchange，提问作者Ahmed Shuaib