管道传输

管道传输允许通过管道程序与远程 shell 进行通信。例如，Linux 上的 ssh。随着 Visual Studio Code 远程开发的引入，管道传输主要适用于物联网场景。

操作指南

pipeTransport 是 launch.json 文件中的一个选项。结构如下所示：

"pipeTransport": {
    "pipeCwd": "/usr/bin",
    "pipeProgram": "/usr/bin/ssh",
    "pipeArgs": [
        "-pw",
        "<password>",
        "user@10.10.10.10"
    ],
    "debuggerPath": "/usr/bin/gdb"
},

pipeArgs 可以是设置和认证管道连接所需的任何一组参数。在示例中，使用了密码，但你也可以使用 SSH 密钥。

你可能还需要添加 sourceFileMap 来映射代码在远程 shell 上的路径到其本地路径：

"sourceFileMap": {
    // "remote": "local"
    "/home/user/src": "/src/projectA/src"
}

附加

你也可以使用上述 pipeTransport 块附加到远程进程。在附加情况下，你需要指定一个 processId。扩展可以从远程机器查询进程。为此，将 processId": "${command:pickProcess} 更改为 processId": "${command:pickRemoteProcess}。pipeTransport 设置将用于查询远程机器上的进程。然后从下拉列表中选择进程。与 launch 一样，你可能需要配置 sourceFileMap。

Docker 示例

pipeTransport 还可以用于调试 Docker 容器中的进程。对于附加，launch.json 将包含：

"pipeTransport": {
    "pipeCwd": "${workspaceFolder}",
    "pipeProgram": "docker",
    "pipeArgs": [
        "exec",
        "-i",
        "hello_gdb",
        "sh",
        "-c"
    ],
    "debuggerPath": "/usr/bin/gdb"
},

其中 hello_gdb 是你的容器名称。

通过启动容器，然后使用相同的 pipeTransport 在容器中启动其他进程来启动进程。请参阅此 launch.json 以获取完整示例。