VS Code Remote SSH 怎样让终端使用远端环境变量

Remote-SSH 连接成功后，Terminal > New Terminal 打开的终端默认运行在远端主机；如果你在本地 User 设置里写变量，远端终端可能看不到。更稳妥的做法是进入当前 SSH 主机的 Remote 设置，在 terminal.integrated.env.linux 中声明变量，再新建终端验证。

官方地址：https://code.visualstudio.com/

先确认终端真的运行在 SSH 主机

连接到目标主机后，观察左下角状态栏是否显示远端名称，再执行菜单 Terminal > New Terminal。不要只看窗口标题判断作用域，主机名和变量值要一起检查。

# 在远端终端确认主机和变量是否来自同一运行环境
printf 'host=%s\n' "$(hostname)"
printf 'APP_ENV=%s\n' "${APP_ENV:-}"
printf 'PROJECT_ROOT=%s\n' "${PROJECT_ROOT:-}"

如果 hostname 已经是远端主机而变量为空，问题通常在设置作用域或终端重建时机，不是 Remote-SSH 没有连接成功。

在远端设置中写入终端环境变量

按 Ctrl+Shift+P 打开命令面板，执行 Preferences: Open Remote Settings (JSON)。这个入口会把配置写到当前 SSH 主机的 Remote 范围，适合只对该远端生效的变量。

在设置文件中加入下面的 JSONC。它是 VS Code 设置文件，注释只用于说明字段；APP_ENV 和 PROJECT_ROOT 请换成自己的值。

{
  // 变量只注入当前远端主机打开的集成终端
  "terminal.integrated.env.linux": {
    // 用于区分远端环境，避免误连本地服务
    "APP_ENV": "staging",
    // 使用远端文件系统中的项目根目录
    "PROJECT_ROOT": "/srv/example-app"
  }
}

保存后回到设置编辑器，确认右侧或当前标签属于 Remote，而不是 User。工作区的 .vscode/settings.json 优先级更高；如果同名变量仍不对，先搜索工作区设置是否有另一份 terminal.integrated.env.linux。

关闭旧终端并验证新变量

设置不会可靠地回写到已经创建的终端进程。先在终端面板关闭旧会话，再执行 Terminal > New Terminal，然后运行：

# 新终端启动后同时检查主机、变量和值的来源
hostname
printenv APP_ENV
printenv PROJECT_ROOT
printf 'shell=%s\n' "${SHELL:-unknown}"

预期能看到远端主机名、staging 和 /srv/example-app。只验证变量而不验证主机，容易把本地终端的配置误认为远端配置。

变量仍为空时的排查顺序

若变量来自 shell 启动文件，建议在远端机器上用与 VS Code 相同的 shell 单独执行一次 printenv，再回到 Remote 窗口重建终端。这样能区分“设置没有保存”和“shell 启动文件没有加载”两类问题。

常见问题

为什么本地 User 设置里的变量在 Remote SSH 终端不出现？

User 设置会被复用，但变量最终仍由当前远端窗口的终端进程决定。需要主机专用值时，使用 Remote Settings；需要项目固定值时，检查工作区设置。

修改设置后为什么旧终端没有变化？

环境变量属于进程启动时的环境。关闭旧终端并新建会话，通常比反复刷新窗口更直接。

应该把变量写进设置还是写进远端 shell 配置？

只服务 VS Code 集成终端的变量适合 Remote 设置；还要供 SSH 登录、脚本和其他工具使用的变量，应放入远端 shell 启动文件，并保持命名一致。