管道传输

管道传输允许通过管道程序与远程 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以获取完整示例。