VS Code远程开发中环境变量需区分终端与UI/调试进程：通过server-env-setup设全局变量，shell配置加VSCODE_IPC_HOOK判断，launch.json/tasks.json配env字段，密钥用ssh-agent或op-cli注入。
在 VS Code 远程开发（Remote-SSH、Dev Containers 或 WSL）中，环境变量和密钥不能像本地开发那样简单写在 .bashrc 或 .zshrc 里就自动生效——VS Code 启动时往往不读取这些 shell 配置，导致 process.env 缺失、CLI 工具报错或连接数据库/云服务失败。关键在于区分「shell 终端环境」和「VS Code UI/调试进程环境」，并为不同场景选择对应方案。
让终端继承正确的环境变量
远程 SSH 或 Dev Container 中打开的集成终端默认可能不加载你的 shell 配置文件，尤其当你用 zsh 但 VS Code 启动的是 bash，或配置了非登录 shell。
- 在远程主机的
~/.vscode-server/server-env-setup（SSH）或/root/.vscode-server/server-env-setup（容器）中写入环境变量，该文件会被 VS Code 服务端显式 source（推荐用于全局、静态变量，如PATH、NODE_ENV） - 在
~/.bashrc或~/.zshrc开头添加：if [ -n "$VSCODE_IPC_HOOK" ]; then return; fi，避免 VS Code 启动时重复执行影响性能；确保export MY_VAR=value在文件末尾或显式被 source - 在 VS Code 设置中启用
"terminal.integrated.inheritEnv": true（默认开启），但注意它只继承 VS Code 主进程的环境，不是终端本身的启动环境
让调试器和任务读取环境变量
launch.json 中的 env 字段或 tasks.json 中的 options.env 是最直接可控的方式，适合项目级、可提交的配置。
- 在
.vscode/launch.json的配置中加："env": { "DATABASE_URL": "${env:DATABASE_URL}" }，引用系统环境变量；或硬编码（仅限开发环境）："env": { "API_KEY": "dev-key-123" } - 使用
envFile字段加载.env文件（需插件支持，如 Code Runner 或自定义 task）；原生 launch.json 不支持，但可通过preLaunchTask调用脚本注入 - 对 Node.js 调试，可配合
dotenv包 +"envFile": "${workspaceFolder}/.env"（需安装 DotENV 插件）
安全地管理密钥（不提交、不硬编码）
密码、API Token、私钥等绝不能写进代码或配置文件。VS Code 本身不提供密钥管理，需借助外部机制，并让开发流程适配。
- 用
ssh-agent管理 SSH 密钥：远程登录后运行eval $(ssh-agent)+ssh-add ~/.ssh/id_rsa，VS Code 的 Remote-SSH 会复用已认证的 agent - 用
pass或1password-cli存储密钥，在server-env-setup或launch.json中通过命令注入："env": { "AWS_ACCESS_KEY_ID": "$(op read op://Dev/AWS/ACCESS_KEY_ID)" }（需提前登录 CLI） - 对 Dev Containers，把密钥挂载为 secret（Docker 20.10+）或通过
remoteEnv在devcontainer.json中声明，再用 entrypoint 脚本注入容器环境
验证与排错小技巧
别猜，直接看实际生效的环境：
- 在集成终端中运行
printenv | grep MY_VAR，确认 shell 层是否生效 - 新建一个
debug-test.js，内容为console.log(process.env.MY_VAR)，用调试器运行，看输出是否符合预期 - 打开命令面板（Ctrl+Shift+P）→
Developer: Toggle Developer Tools→ Console 标签页，输入process.env.MY_VAR（仅适用于部分扩展或 Webview 场景） - 检查 VS Code 窗口右下角状态栏：Remote-SSH 连接成功后，点击它可查看当前连接的用户、主机、环境变量摘要（部分版本支持）
基本上就这些。核心是分清“谁在读环境”——终端、调试器、任务、扩展，各自有不同加载路径。不复杂但容易忽略，配一次，后续省心。
