如何在Visual Studio Code中设置环境变量?
当然可以在VS Code里设置环境变量,而且有好几种不同的方式,适配不同的使用场景,我给你一一拆解清楚:
在VS Code中设置环境变量的实用方法
1. 全局/工作区级终端环境变量(永久生效)
如果你希望VS Code内置终端每次打开都自动加载特定环境变量,可以通过设置面板配置:
- 打开设置快捷键:Windows/Linux用
Ctrl+,,Mac用Cmd+, - 在搜索框输入
terminal.integrated.env,选择「用户设置」(所有项目生效)或「工作区设置」(仅当前项目生效) - 点击「编辑 in settings.json」,根据你的系统添加变量:
// Windows系统 "terminal.integrated.env.windows": { "MY_PROJECT_VAR": "hello_vscode", "PATH": "${env:PATH};D:\\my\\tools\\path" }, // Linux系统 "terminal.integrated.env.linux": { "MY_PROJECT_VAR": "hello_vscode", "PATH": "${env:PATH}:/home/my/tools/path" }, // macOS系统 "terminal.integrated.env.osx": { "MY_PROJECT_VAR": "hello_vscode", "PATH": "${env:PATH}:/Users/my/tools/path" }
这里的 ${env:PATH} 是引用系统原有PATH变量,避免覆盖掉系统默认的路径配置。
2. 调试会话专属环境变量
如果你是在调试代码(比如Node.js、Python、C#等),需要让调试进程加载特定变量,就去配置 launch.json:
- 打开「运行和调试」面板(快捷键
Ctrl+Shift+D) - 点击「创建launch.json文件」,选择对应的调试器(比如Node.js)
- 在配置项里添加
env字段,示例如下:
{ "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "Launch My App", "program": "${file}", "env": { "NODE_ENV": "development", "API_SECRET_KEY": "my_secure_key_123" } } ] }
这种方式的变量只在调试运行时生效,不会影响终端的环境。
3. 终端临时设置(单次会话有效)
如果只是临时用一次环境变量,不用改配置,直接在VS Code终端里输入命令就行:
- Windows PowerShell:
$env:MY_TEMP_VAR = "temporary_value" - Linux/macOS(bash/zsh):
export MY_TEMP_VAR="temporary_value"
注意:这种设置只对当前终端窗口有效,关闭终端后变量就消失了。
4. .env文件+扩展管理项目变量
很多项目会用 .env 文件集中管理环境变量,VS Code可以配合扩展让这个流程更顺畅:
- 先在项目根目录创建
.env文件,写入变量:
DB_HOST=localhost DB_PORT=5432 API_KEY=abcdefg
- 安装「DotENV」扩展,它会高亮
.env文件语法,还能帮助识别变量 - 如果是Node.js这类项目,可以用
dotenv包在代码中加载.env里的变量;要是想让终端自动加载,可以在终端的启动脚本里添加加载逻辑(比如bash里加source .env)
小提示
- 如果设置后变量没生效,试试重启VS Code终端或者整个编辑器
- 工作区设置的优先级高于用户设置,所以同一变量在工作区和用户设置都存在时,会用工作区的
- 敏感变量(比如密钥)记得把
.env添加到.gitignore,别提交到代码仓库里
内容的提问来源于stack exchange,提问作者Shakti Kumar Das




