Electron中alwaysOnTop: true为何在其他应用全屏时失效？

核心问题原因 #

Electron默认的alwaysOnTop: true仅能在普通窗口层级保持置顶，当其他应用进入全屏（F11或独占全屏）模式时，系统会将全屏窗口的层级提升到更高优先级，导致Electron窗口被覆盖。以下是几个可行的解决思路：

1. 调用系统原生API强制置顶（Windows平台） #

通过调用Windows的SetWindowPos系统API，直接将窗口设置为HWND_TOPMOST层级，该层级优先级高于普通全屏窗口。

实现步骤：

• 安装ffi-napi模块（用于调用Windows原生API）：

  npm install ffi-napi
  

• 在主进程中编写代码：

  const { BrowserWindow } = require('electron');
  const ffi = require('ffi-napi');
  
  const win = new BrowserWindow({
    width: 300,
    height: 200,
    alwaysOnTop: true,
    webPreferences: { nodeIntegration: true }
  });
  
  // 定义Windows user32库的SetWindowPos函数
  const user32 = ffi.Library('user32', {
    'SetWindowPos': ['bool', ['int', 'int', 'int', 'int', 'int', 'int', 'uint']]
  });
  
  const HWND_TOPMOST = -1;
  const SWP_NOMOVE = 0x0002; // 不改变窗口位置
  const SWP_NOSIZE = 0x0001; // 不改变窗口大小
  
  // 窗口加载完成后调用API
  win.on('ready-to-show', () => {
    const handle = win.getNativeWindowHandle();
    // 根据系统位数读取句柄（32位用readInt32LE，64位用readInt64LE）
    const hwnd = process.arch === 'x64' ? handle.readInt64LE() : handle.readInt32LE();
    user32.SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE);
  });
  

2. 调整Electron窗口层级参数 #

Electron允许设置窗口的置顶层级，使用screen-saver或status层级可以获得更高优先级，覆盖普通全屏窗口。

实现代码：

const { BrowserWindow, screen } = require('electron');

const win = new BrowserWindow({
  width: 300,
  height: 200,
  alwaysOnTop: true,
  webPreferences: { nodeIntegration: true }
});

// 设置更高优先级的置顶层级
win.setAlwaysOnTop(true, 'screen-saver', 1);

// 监听显示变化，动态重新置顶（防止被全屏窗口挤下去）
screen.on('display-metrics-changed', () => {
  setTimeout(() => {
    win.setAlwaysOnTop(true, 'screen-saver', 1);
  }, 100);
});

• 说明：screen-saver层级在Windows和macOS上均有效，第三个参数为优先级数值，数值越大优先级越高。

3. macOS平台特殊处理 #

在macOS上，可以将窗口层级设置为status（状态栏层级），该层级会在所有全屏应用之上显示：

const { BrowserWindow } = require('electron');

const win = new BrowserWindow({
  width: 300,
  height: 200,
  alwaysOnTop: true,
  webPreferences: { nodeIntegration: true }
});

win.setWindowLevel('status');

局限性说明 #

• 若其他应用使用独占全屏模式（如部分3D游戏），系统会直接接管显示输出，此时任何窗口都无法置顶，这是系统级限制，无法绕过。
• 部分系统安全软件或权限设置可能会阻止窗口置顶操作，需确保应用有足够的系统权限。

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