You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

如何在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

火山引擎 最新活动