VSCode Remote-WSL环境下调用Windows主机mGBA的调试配置问题

解决方案 #

方案1：调整启动命令，让任务直接返回完成状态 #

这是最简洁的解决方式，利用Windows系统的cmd.exe内置的start命令启动mGBA，start会在启动程序后直接退出，不会等待mGBA关闭，因此任务会立刻标记为完成，调试器可以正常启动。

修改你的mGBA_debug任务配置如下：

{
    "label": "mGBA_debug",
    "type": "process",
    "command": "cmd.exe",
    "args": [
        "/c",
        "start",
        "mGBA Debug",
        "D:\\Pokémon Hacking\\Software\\mgba\\mGBA.exe",
        "-g",
        "pokefirered_debug.gba"
    ],
    "group": "test",
    "dependsOn": ["Build FireRed Debug"],
    "presentation": {
        "panel": "dedicated",
        "showReuseMessage": false,
        "close": true
    }
}

注意：这里mGBA的路径要换成Windows识别的绝对路径，如果你需要传入WSL文件系统内的ROM文件，可以把ROM路径参数替换为$(wslpath -w ./pokefirered_debug.gba)，自动把WSL路径转为Windows路径。
这个方案可以删除原有的isBackground配置，因为任务执行完就会正常结束，不会占用后台。

方案2：完善后台任务的就绪匹配规则 #

你之前的isBackground配置未生效，是因为VSCode需要明确的规则判断后台任务是否已经完成就绪、可以进入下一步调试。你需要补充problemMatcher配置，匹配mGBA启动GDB服务后的输出作为就绪信号。

修改后的mGBA_debug任务配置如下：

{
    "label": "mGBA_debug",
    "type": "process",
    "command": "/mnt/d/Pokémon Hacking/Software/mgba/mGBA.exe",
    "args": [
        "-g",
        "pokefirered_debug.gba"
    ],
    "group": "test",
    "isBackground": true,
    "dependsOn": ["Build FireRed Debug"],
    "presentation": {
        "panel": "dedicated",
        "showReuseMessage": false,
        "close": true
    },
    "problemMatcher": {
        "pattern": {
            "regexp": "^$",
            "file": 1,
            "location": 2,
            "message": 3
        },
        "background": {
            "activeOnStart": true,
            "beginsPattern": "^.*Starting mGBA.*$",
            "endsPattern": "^.*Waiting on GDB connection on port 2345.*$"
        }
    }
}

注意：endsPattern的正则需要和你使用的mGBA版本实际输出的等待连接日志匹配，如果你的mGBA输出内容不同，调整正则即可。当VSCode匹配到对应输出后，就会认为任务已经就绪，自动启动调试器，不需要等待mGBA进程结束。

WSL调用Windows宿主机应用的最优实现说明 #

• 前台启动CLI程序、需要等待执行结果的场景：直接调用.exe程序即可，WSL会自动同步进程状态和输出。
• 后台启动GUI程序、不需要等待进程结束的场景：统一使用cmd.exe /c start "窗口标题" 程序路径 参数的方式调用，是最稳定不会出现进程绑定、路径识别问题的方案。

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