You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

WSL Ubuntu环境下Electron启动报SIGTRAP错误无法正常运行如何解决

问题原因

该报错是WSL环境缺少Electron运行所需的图形渲染依赖、或没有配置图形输出通道导致的窗口初始化崩溃,你使用的官方入门代码本身不存在语法/逻辑问题。

解决方案

按以下步骤操作即可正常启动应用:

  • 安装系统依赖
    在WSL的Ubuntu终端执行如下命令安装Electron运行必备的系统库:
    sudo apt update && sudo apt install -y libnss3 libgtk-3-0 libxss1 libasound2 libgbm1
    
  • 配置图形输出通道
    如果你使用Windows 10系统无WSLg支持,需要先在Windows侧安装VcXsrv等X Server工具,启动时勾选「Disable access control」,再在WSL终端执行如下命令配置输出环境变量:
    export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0
    
    如需永久生效,可将上述命令写入~/.bashrc或对应shell的配置文件后执行source生效。
    如果你使用Windows 11自带WSLg环境,可跳过本步骤。
  • 添加Electron启动参数
    WSL环境默认不支持Electron的沙箱机制,需要添加禁用沙箱的启动参数,有两种修改方式二选一即可:
    1. 修改package.json中的start脚本:
    "scripts": {
      "start": "electron . --no-sandbox"
    }
    
    1. 在main.js的app初始化前添加开关:
    const { app, BrowserWindow } = require('electron')
    app.commandLine.appendSwitch('no-sandbox') // 新增这行
    
  • 重新执行npm start,即可正常弹出应用窗口。

内容的提问来源于stack exchange,提问作者mycupisoverflowing

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 23:45:01