Windows系统下如何永久配置process.env环境变量用于VS Code生产测试
永久生效Windows环境变量及替代解决方案
方案1:写入Windows系统全局环境变量
- 图形化操作步骤:
- 按下
Win + S搜索「编辑系统环境变量」,点击打开对应系统面板 - 点击右下角「环境变量」按钮
- 按需选择存储范围:「用户变量」仅对当前Windows登录账号生效,「系统变量」对设备所有账号生效,点击对应区域的「新建」按钮
- 分别填入变量名(KEY)和变量值(VALUE),依次点击确定保存所有打开的配置窗口
- 修改完成后需要完全关闭VS Code(包括后台驻留进程)再重启,新的环境变量才会被VS Code加载
- 按下
- 命令行操作步骤(需要以管理员权限打开PowerShell执行):
写入当前用户变量:[Environment]::SetEnvironmentVariable("KEY", "VALUE", "User")
写入系统全局变量:[Environment]::SetEnvironmentVariable("KEY", "VALUE", "Machine")
执行完成后同样需要重启VS Code生效。
方案2:项目级环境变量配置(更推荐)
无需修改系统全局配置,可避免多项目环境变量冲突,适合Web项目开发测试场景:
- 在项目根目录新建
.env文件,每行按KEY=VALUE的格式写入需要的环境变量 - 按项目运行环境选择加载方式:
- Node.js v20.6.0及以上版本原生支持,启动时添加参数即可:
node --env-file=.env 项目启动文件.js - 低版本Node.js或通用前端/Node项目:安装
dotenv依赖包,在项目入口文件最顶部添加代码require('dotenv').config()即可自动加载.env内的变量 - 框架自带环境变量能力(如Vite、Create React App、Next.js等):无需额外安装依赖,按框架要求命名.env文件(如
.env.production用于生产模式),框架会自动加载对应变量到process.env中
- Node.js v20.6.0及以上版本原生支持,启动时添加参数即可:
- 注意:务必将
.env文件添加到.gitignore规则中,避免敏感配置被提交到代码仓库
方案3:仅针对VS Code终端生效的配置
如果不需要全局生效,只希望在VS Code的内置终端中使用这些变量:
- 按下
Ctrl + ,打开VS Code设置,搜索terminal.integrated.env.windows - 点击「在settings.json中编辑」,添加如下配置:
"terminal.integrated.env.windows": { "KEY": "VALUE" }
- 保存配置后重启VS Code终端即可生效,变量仅对VS Code内置终端有效。
内容的提问来源于stack exchange,提问作者Pratham Bansal
相关产品推荐
相关产品推荐

