VSCode中的环境变量如何配置和使用？_网络技术

发布时间 - 2025-12-20 00:00:00 点击率：次

VSCode中配置环境变量有四种方式：一、launch.json专用于调试；二、settings.json设置终端启动环境；三、.env文件配合插件自动加载；四、tasks.json配置任务级环境变量。

如果您在 VSCode 中运行脚本时遇到环境变量未生效、程序无法读取预期配置或调试器报错提示变量缺失等问题，则可能是由于 VSCode 未正确加载或传递环境变量。以下是配置和使用环境变量的多种方式：

本文运行环境：MacBook Pro，macOS Sequoia。

一、通过 launch.json 配置调试环境变量

此方法专用于调试会话，可为每个调试配置独立设置环境变量，不影响终端或其他扩展行为。

1、在项目根目录下创建 .vscode/launch.json 文件（若不存在）。

2、在 configurations 数组中选择目标调试配置，添加 env 字段。

3、在 env 对象内以键值对形式写入变量，例如 "NODE_ENV": "development"。

4、保存文件后重启调试会话，变量将注入到调试进程的环境上下文中。

此方法影响 VSCode 内置终端的初始环境，适用于需在集成终端中运行命令并依赖特定变量的场景。

1、打开 VSCode 设置（Cmd+,），切换至“工作区”选项卡。

2、点击右上角“打开设置(JSON)”图标，进入 settings.json 编辑界面。

3、添加 terminal.integrated.env.osx 字段（macOS）或 terminal.integrated.env.linux / terminal.integrated.env.windows。

4、在对应字段中填入 JSON 对象，例如 {"PYTHONPATH": "/Users/name/project/src"}。

此方法无需修改 VSCode 配置文件，利用第三方插件在启动时自动读取项目根目录下的 .env 文件并注入变量。

1、在项目根目录新建 .env 文件，每行写一个变量，格式为 KEY=VALUE。

2、安装官方推荐插件 Env File Loader 或社区常用插件 DotENV。

3、重启 VSCode，插件将自动解析 .env 并将其应用于当前工作区的终端与调试会话（具体范围依插件实现而定）。

此方法适用于自定义构建、测试等任务，确保执行 task 时进程拥有指定环境变量。

1、在 .vscode/tasks.json 中定位到目标 task 的 definition 或 options 节点。

2、在 options 下添加 env 字段，结构与 launch.json 中一致。

3、若需覆盖系统级变量，可在 env 中显式指定，如 "PATH": "/opt/homebrew/bin:${env:PATH}"。

4、运行该任务（Ctrl+Shift+P → Tasks: Run Task），变量即生效于该 task 子进程。