Fedora Linux系统下Electron DevTools Inspector无法显示问题求助

常见问题根因 #

90%以上该类故障是Fedora默认使用的Wayland显示服务器，与应用内置的Electron版本DevTools组件存在适配冲突，导致DevTools窗口虽然进程启动，但无法正常渲染显示。

修复步骤 #

方案1：使用X11后端启动应用（优先验证） #

可先通过临时修改启动参数验证是否为适配问题：

• 打开终端，进入应用可执行文件所在目录，在原有启动命令后追加两个参数运行：

  ./<你的应用名称> --enable-features=WaylandWindowDecorations --ozone-platform=x11
  

• 启动应用后再次尝试唤起DevTools，若可正常显示，则确认为Wayland适配问题，可按后续操作实现永久生效。

方案2：永久修改应用启动参数 #

若临时测试生效，可修改桌面快捷方式默认添加适配参数：

• 找到应用对应的.desktop配置文件，通常路径为~/.local/share/applications/（当前用户安装）或/usr/share/applications/（全局安装）
• 编辑文件，找到以Exec=开头的行，在行尾追加--enable-features=WaylandWindowDecorations --ozone-platform=x11参数后保存
• 执行update-desktop-database命令刷新桌面快捷方式缓存，后续从图标启动应用即可正常使用DevTools。

方案3：其他兼容问题修复 #

若上述操作无效，可尝试以下排查：

• 补全Electron运行依赖，执行命令：sudo dnf install nss at-spi2-atk at-spi2-core gtk3
• 若应用使用的是14版本以下的旧版Electron，可追加--disable-gpu参数启动，避免GPU渲染异常导致DevTools无法弹出
• 检查系统窗口管理器规则，确认是否存在将DevTools窗口默认最小化、移动到其他工作区或者隐藏的规则，唤起DevTools后可切换工作区查看是否有遗漏窗口。

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