管道传输

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

操作指南

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。