远程SSH Linux主机VS Code任务执行source配置环境失效问题

我需要在远程Linux主机上为嵌入式目标平台交叉编译项目，该项目需预先配置环境。我有一套环境配置脚本，在远程主机本地Shell执行能正确设置环境变量，基于此的构建脚本可成功完成本地编译。

但通过Visual Studio Code的Remote SSH扩展连接该主机后，尽管已通过tasks.json配置source任务执行上述脚本，环境变量仍未生效，导致构建脚本无法找到正确路径，编译失败。

我的tasks.json文件如下：

{    
    // See https://go.microsoft.com/fwlink/?LinkId=733558    
    // for the documentation about the tasks.json format    
    "version": "2.0.0",    
    "tasks": [
        {
            "label": "env",
            "type": "shell",
            "command": "source",
            "args": ["/opt/fslc-framebuffer/2.5-qt/environment-setup-armv7at2hf-neon-fslc-linux-gnueabi"]
        },
        {
            "label": "qmake frontend",
            "type": "shell",
            "command": "/opt/fslc-framebuffer/2.5-qt/sysroots/x86_64-fslcsdk-linux/usr/bin/qmake",
            "args": ["${workspaceFolder}/frontend/frontend.pro", "-config", "release", "CONFIG+=imx6ul-linux"],
            "problemMatcher": [
                "$gcc"
            ],
        },
        {
            "label": "build frontend",
            "dependsOn": [
                "env",
                "qmake frontend"
            ],
            "dependsOrder": "sequence",
            "problemMatcher": [],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]  
}

我尝试过以下方案但未解决问题：

• 研究如何在tasks.json中运行source命令
• 尝试让tasks.json复用同一个shell
• 尝试在VSCode启动前运行远程脚本

问题核心在于VSCode的每个shell任务都是独立进程，前一个env任务中source脚本设置的环境变量，无法传递给后续的qmake frontend任务。要让环境变量生效，必须让source脚本和qmake命令在同一个shell进程中执行。

以下两种修改方式均可解决问题：

方式一：合并source与qmake到同一任务 #

修改qmake frontend任务，用shell的-c参数串联执行source和qmake命令，确保两者在同一进程中运行：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "qmake frontend",
            "type": "shell",
            "command": "bash",
            "args": [
                "-c",
                "source /opt/fslc-framebuffer/2.5-qt/environment-setup-armv7at2hf-neon-fslc-linux-gnueabi && /opt/fslc-framebuffer/2.5-qt/sysroots/x86_64-fslcsdk-linux/usr/bin/qmake ${workspaceFolder}/frontend/frontend.pro -config release CONFIG+=imx6ul-linux"
            ],
            "problemMatcher": ["$gcc"]
        },
        {
            "label": "build frontend",
            "dependsOn": ["qmake frontend"],
            "dependsOrder": "sequence",
            "problemMatcher": [],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

方式二：直接在构建任务中执行完整命令链 #

简化任务结构，让默认构建任务直接执行source+qmake的完整命令序列，无需拆分任务：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build frontend",
            "type": "shell",
            "command": "bash",
            "args": [
                "-c",
                "source /opt/fslc-framebuffer/2.5-qt/environment-setup-armv7at2hf-neon-fslc-linux-gnueabi && /opt/fslc-framebuffer/2.5-qt/sysroots/x86_64-fslcsdk-linux/usr/bin/qmake ${workspaceFolder}/frontend/frontend.pro -config release CONFIG+=imx6ul-linux && make"
            ],
            "problemMatcher": ["$gcc"],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

额外说明 #

如果你的环境脚本依赖特定Shell（比如zsh），将上述代码中的bash替换为对应Shell名称即可。这种方式完全复刻了本地Shell中执行命令的逻辑，能确保环境变量全程生效。

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