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

在WSL(Ubuntu22.04 LTS)中启动Spyder遇Qt xcb插件加载失败求助

解决WSL Ubuntu 22.04中Spyder启动的Qt xcb插件报错问题
  • 检查WSL图形支持
    先确认WSL 2和WSLg已启用:
    在PowerShell里运行wsl --version,查看输出里是否包含WSLg相关内容。如果没有,执行wsl --update更新WSL,再用wsl --shutdown重启WSL,重新打开Ubuntu终端。

  • 补全Qt依赖库
    xcb插件加载失败通常是缺少相关依赖包,在Ubuntu终端执行以下命令安装:
    sudo apt update && sudo apt install libxcb-xinerama0 libxcb-cursor0 libxcb-randr0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-shape0 libxcb-sync1 libxcb-xfixes0 libxcb-xkb1 libxkbcommon-x11-0

  • 修正DISPLAY环境变量
    先运行echo $DISPLAY,如果输出为空或不符合预期,手动设置环境变量:
    export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0
    设置完成后再启动Spyder:spyder

  • 临时用offscreen模式启动(仅应急)
    若前面的方法都无效,可以尝试无界面模式启动(仅适合运行脚本,无图形交互):
    QT_QPA_PLATFORM=offscreen spyder

  • 重装Spyder并清理配置
    卸载现有Spyder并清理旧配置文件:
    pip uninstall -y spyder && rm -rf ~/.config/spyder-py3
    之后重新安装:pip install spyder
    如果你是通过apt安装的Spyder,可替换为以下命令:
    sudo apt remove --purge spyder && sudo apt install spyder

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.25 20:17:15