Jin 的个人思考

Electron Wayland原生支持 - 技术深度解析

★★★★★ 5星 | 2026-03-20 | Electron Wayland Linux 桌面开发

概述

当Electron在去年秋天切换到Wayland时，大多数人并没有注意到。但实际上这是Linux桌面应用生态的重大变化——Chromium在2025年8月默认启用Wayland，携带着Electron和数十个Linux桌面应用一起完成了第二次Wayland迁移。

关键版本： Electron 38.2+ 默认支持Wayland，Electron 41+ 支持frameless窗口的CSD

Wayland的核心变化

1. 窗口管理限制

Wayland重新审视了旧系统的假设，以下是它"不允许"应用做的事情：

  • 从其他应用抢夺焦点
  • 查看和交互其他应用的窗口
  • 未聚焦时响应鼠标和键盘输入
  • 自主选择窗口位置和显示器
  • 随时调整窗口大小
影响： 一些广泛使用的Electron API在Wayland上不可用，例如：
  • win.setPosition(x, y) - 无法设置窗口位置
  • screen.getCursorScreenPoint() - 无法获取全局屏幕坐标

2. 客户端装饰（CSD）的挑战

Wayland协议非常轻量，创建窗口时只返回一个矩形。要添加用户期望的装饰（标题栏按钮、阴影、调整大小句柄），需要实现客户端装饰（CSD）。

CSD的技术实现：

  • window bounds: 包含标题栏、菜单栏和框架的窗口大小
  • content bounds: 承载应用Web内容的内部web view大小
  • widget bounds: 绘制所有内容（包括窗口框架和外部装饰）的透明widget大小
技术细节： 当需要CSD时，Electron首先获取窗口的基础surface，然后"膨胀"它以容纳所有装饰。框架将窗口的不透明部分（标题栏、框架和Web内容）绘制在透明widget内的适当位置。

3. 不同Compositor的兼容性

Wayland不是一个单一的软件，而是一个协议。每个Compositor的实现都略有不同：

  • Slack在GNOME (Mutter)上尝试聚焦时：显示通知
  • Slack在KDE Plasma (KWin)上尝试聚焦时：面板中的图标闪烁

Wayland的安全优势

虽然限制更多，但Wayland也提供了更好的安全性：

  • 更强的应用间隔离
  • 输入隔离防止clickjacking
  • 1Password SSH agent可以利用Wayland的安全模型，让用户只需点击一次确认而不是输入密码

新功能支持

  • 可变刷新率（Variable Refresh Rates）
  • HiDPI和分数缩放
  • HDR和宽色域
  • win.setOpacity(n) - 之前在Linux上不可用，现在可以支持
  • 圆角窗口（未来可能支持）

开发者行动建议

  1. 使用Electron 41+测试应用
  2. 在Ubuntu 25.10或Fedora 43等现代发行版上测试
  3. 同时在KDE Plasma和GNOME上测试
  4. 考虑更exotic的Wayland compositor如Niri

总结

Wayland是2026年Linux用户的日常现实，出色的Wayland体验现在是支持Linux的基本要求。Electron的基本支持已经到位，特别是CSD为开发者提供了更多定制窗口框架的方式。

来源： Electron Blog - Tech Talk: How Electron went Wayland-native

标签： Electron, Wayland, Linux Desktop, CSD, Client-Side Decorations