Java Swing程序报错No X11 DISPLAY变量未设置问题求助

错误原因 #

GitHub Codespace默认是**无头(Headless)**运行环境，没有本地图形显示服务，而Swing依赖X11图形系统渲染界面，创建JFrame时因找不到DISPLAY环境变量触发HeadlessException。

解决方案 #

方法1：使用VS Code X11转发插件 #

• 在VS Code扩展市场搜索并安装Remote - X11插件（适配Codespace环境）
• 重启VS Code并重新连接到你的Codespace
• 在终端执行命令设置DISPLAY变量：

  export DISPLAY=:0
  

• 重新编译运行你的Java代码

方法2：使用xvfb虚拟显示（无需插件） #

• 在Codespace终端安装xvfb虚拟显示服务：

  sudo apt update && sudo apt install -y xvfb
  

• 启动虚拟显示会话：

  Xvfb :0 -screen 0 1024x768x16 &
  

• 设置DISPLAY环境变量：

  export DISPLAY=:0
  

• 编译并运行代码：

  javac Main.java && java Main
  

代码小优化（可选） #

你实现了KeyListener但未注册到组件，后续要处理键盘事件需补充：

public Main() {
    // ... 原有代码 ...
    this.addKeyListener(this);
    this.setFocusable(true);
    this.requestFocusInWindow();
}

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