VSCode WSL调试启动失败：wsl.exe管道程序启动出错

问题分析 #

错误提示明确指出工作目录 /mnt/c/wsl shared/CodeV3 不存在，核心原因是该路径在WSL环境中无法被正确识别或实际未创建。

解决方案步骤 #

1. 验证并创建WSL中的目标目录 #

打开WSL终端，执行命令检查目录是否存在：

ls "/mnt/c/wsl shared/CodeV3"

若提示No such file or directory，则创建该目录：

mkdir -p "/mnt/c/wsl shared/CodeV3"

2. 修复launch.json中的路径空格处理 #

路径中的空格会导致WSL解析异常，可通过以下方式调整：

• 转义路径空格：在cwd和pipeCwd字段中，将空格用双反斜杠转义（JSON语法要求）：

  "cwd": "/mnt/c/wsl\\ shared/CodeV3",
  "pipeTransport": {
      "pipeCwd": "/mnt/c/wsl\\ shared/CodeV3",
      // 其他配置保留
  }
  

• 通过pipeArgs指定工作目录：修改pipeArgs，让wsl.exe显式切换到目标目录：

  "pipeTransport": {
      "pipeProgram": "C:\\Windows\\System32\\wsl.exe",
      "pipeArgs": ["-e", "bash", "-c", "cd \"/mnt/c/wsl shared/CodeV3\" && exec /usr/bin/gdb"],
      "debuggerPath": "/usr/bin/gdb"
  }
  

3. 确认C盘在WSL中的挂载状态 #

若上述步骤无效，检查WSL是否正确挂载Windows C盘：
在WSL终端执行：

mount | grep /mnt/c

若无输出，执行挂载命令：

sudo mount -t drvfs C: /mnt/c

4. 修复目录权限 #

确保WSL用户对目标目录有访问权限：

chmod -R 755 "/mnt/c/wsl shared/CodeV3"

修改后的完整launch.json示例 #

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "WSL: Launch CTCInterface",
            "type": "cppdbg",
            "request": "launch",
            "program": "/mnt/c/wsl_shared/CodeV3/build/CTCInterface",
            "args": [],
            "stopAtEntry": false,
            "cwd": "/mnt/c/wsl\\ shared/CodeV3",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "/usr/bin/gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "CMake: build",
            "pipeTransport": {
                "pipeCwd": "/mnt/c/wsl\\ shared/CodeV3",
                "pipeProgram": "C:\\Windows\\System32\\wsl.exe",
                "pipeArgs": [],
                "debuggerPath": "/usr/bin/gdb"
            },
            "sourceFileMap": {
                "/mnt/c": "C:\\"
            }
        }
    ]
}

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