Windows系统下Electron如何在现有窗口打开关联文件而非新建窗口

实现方案 #

Windows 平台的文件关联触发逻辑和 macOS 不同：双击关联文件时，系统默认会启动新的应用进程，而非给已运行的进程发事件，所以需要通过「单实例锁」拦截新进程启动，把文件打开请求转发给已有的实例窗口，具体实现如下：

第一步：添加单实例锁逻辑 #

在应用启动的最早期（ready 事件触发前）添加单实例锁判断，如果已经有运行的实例，直接退出当前新进程。

第二步：监听新实例启动事件 #

已有实例运行时，新进程启动会触发 second-instance 事件，从新进程的启动参数中提取文件路径，交给已有窗口处理。

第三步：兼容首次启动场景 #

首次启动应用时，直接从当前进程的启动参数中提取文件路径处理。

完整实现代码：

// 最顶部先处理单实例锁，必须放在app.on('ready')之前
const gotTheLock = app.requestSingleInstanceLock()
if (!gotTheLock) {
  // 已经有实例在运行，直接退出当前新进程
  app.quit()
}

let win = null
async function createWindow() {
  // 保留你原有创建窗口的逻辑即可
}

app.on('will-finish-launching', () => {
  // macOS 原生打开文件事件保留
  app.on('open-file', async (event, path) => {
    event.preventDefault()
    if (!win) {
      win = await createWindow()
    }
    // 唤醒窗口到前台
    if (win.isMinimized()) win.restore()
    win.focus()
    win.webContents.send('open-file', path)
  })
})

// 监听新实例启动事件，仅Windows/Linux会触发
app.on('second-instance', async (event, commandLine) => {
  // 从新实例的启动参数中提取文件路径
  let openFilePath = null
  if (process.platform === 'win32') {
    // 打包后参数位置是argv[1]，开发环境是argv[2]（开发时argv[1]是入口脚本路径）
    if (app.isPackaged) {
      openFilePath = commandLine.length >= 2 ? commandLine[1] : null
    } else {
      openFilePath = commandLine.length >= 3 ? commandLine[2] : null
    }
  }

  if (win) {
    // 唤醒已有窗口
    if (win.isMinimized()) win.restore()
    win.focus()
    if (openFilePath) {
      win.webContents.send('open-file', openFilePath)
    }
  }
})

app.on('ready', async () => {
  if (!app.isPackaged && !process.env.IS_TEST) {
    // Install Vue Devtools
    try {
      await installExtension(VUEJS_DEVTOOLS)
    } catch (e) {
      console.error('Vue Devtools failed to install:', e.toString())
    }
  }
  if (!win) {
    win = await createWindow()
    // 首次启动时处理Windows下传入的文件路径
    let openFilePath = null
    if (process.platform === 'win32') {
      if (app.isPackaged) {
        openFilePath = process.argv.length >= 2 ? process.argv[1] : null
      } else {
        openFilePath = process.argv.length >= 3 ? process.argv[2] : null
      }
    }
    if (openFilePath) {
      win.webContents.send('open-file', openFilePath)
    }
  }
})

补充说明 #

打包应用时需要正确配置文件关联规则，确保双击文件时路径参数能正常传入应用；如果你的应用还支持自定义协议链接打开，也可以复用这套 second-instance 事件的处理逻辑。

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