VSCode Live Share协作开发Java游戏如何在各自PC正常编译运行

VS Code Live Share 默认仅同步代码文件、共享终端会话、调试会话的文本输出，不会自动转发java.awt实现的GUI窗口渲染流。协作者看不到窗口的核心原因基本都是误用了主机的共享终端运行程序：这种模式下进程实际运行在主机上，GUI资源只在主机侧加载渲染，自然只会在主机屏幕弹出窗口，协作者本地根本没启动对应进程。

通用前置配置（双方都需要完成） #

• 本地安装完整版本JDK 8及以上版本，禁止使用服务器场景的headless精简版JDK。安装完成后在本地终端执行java -version，确认输出内容中没有headless字样。
• 本地VS Code安装Extension Pack for Java插件，不要仅安装Live Share相关插件。
• 在项目根目录提交统一的.vscode/settings.json配置，固定编译运行参数，避免双端环境差异导致的异常，配置参考：

{
    "java.project.sourcePaths": ["src"],
    "java.project.outputPath": "bin",
    "java.debug.settings.forceBuildBeforeLaunch": true,
    "java.awt.headless": false
}

• 在项目根目录提交统一的.vscode/launch.json启动配置，固定游戏主类入口，避免协作者找不到启动类，配置参考：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "启动游戏",
            "request": "launch",
            "mainClass": "替换为项目实际的游戏主类全限定名，例如com.mygame.Main",
            "vmArgs": "-Djava.awt.headless=false"
        }
    ]
}

• 如果项目使用Maven/Gradle构建，检查构建配置，确保没有全局设置java.awt.headless=true的JVM参数。

主机侧配置 #

• 开启Live Share会话时，仅共享代码工作区即可，不要将共享终端作为默认运行入口开放给协作者。
• 如果需要临时给协作者演示运行效果，直接使用VS Code自带的屏幕共享功能展示窗口即可，不要引导协作者在共享终端内执行编译、运行命令。

协作者侧配置 #

• 加入Live Share会话后，等待所有代码文件同步完成，观察VS Code底部Java语言服务的索引进度条，等进度走完、无项目报错后再执行后续操作。
• 禁止在主机提供的共享终端中执行任何编译、运行Java程序的命令：共享终端内启动的所有进程都运行在主机侧，GUI只会在主机弹出。要运行程序时，直接切换到VS Code左侧「运行和调试」面板，选择预置的「启动游戏」配置点击运行，此时进程会直接跑在本地PC上，调用本地awt类库弹出游戏窗口。
• 如果第一次运行提示找不到主类，按Ctrl+Shift+P调出命令面板，执行Java: Clean Java Language Server Workspace，等待语言服务重载完成后再启动。
• 如果使用Linux系统，提前安装awt依赖的X11组件，例如Ubuntu/Debian系可执行sudo apt install libxext-dev libxrender-dev libxtst-dev安装依赖。

• 运行时抛出java.awt.HeadlessException：优先检查启动配置的vmArgs是否添加了-Djava.awt.headless=false，再确认本地安装的JDK不是headless精简版本。
• 点击运行后无任何窗口弹出：不要使用Live Share的「联合调试」功能启动程序，联合调试模式下进程默认运行在主机侧，协作者只能看到控制台输出和调试变量，无法拉起本地GUI窗口。
• 编译报错找不到类：检查本地JDK版本是否和项目要求一致，清理Java语言服务缓存后重新索引项目即可。

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