vscode终端npm run读不到环境变量,根本原因是终端未加载shell配置(如~/.zshrc)、powershell执行策略阻止.ps1脚本运行,或dotenv未显式注入cli命令;需设terminal.integrated.shellargs为["-l"]、执行set-executionpolicy remotesigned -scope currentuser,并用cross-env正确传参。

VSCode终端里npm run脚本读不到环境变量,不是脚本写错了,而是终端根本没加载你定义的变量。
npm run脚本在VSCode中不读.env文件
Node项目常用dotenv加载.env,但npm run本身不自动读取它——这是常见误解。脚本执行时,dotenv只对当前Node进程生效,而npm run启动的是shell子进程,.env不会自动注入到那里。
- 确认你的脚本是否真依赖
dotenv:比如"start": "node index.js"会触发require('dotenv').config();但"build": "webpack --mode=production"这类外部CLI命令不会 - 若需在CLI命令中用环境变量,得显式加载:
"build": "dotenv -- webpack --mode=production"(需先npm install -D dotenv-cli) - 别把
.env路径写错:dotenv默认只读项目根目录下的.env,不递归查找
VSCode终端启动时未加载shell配置中的export
你在~/.zshrc或~/.bash_profile里写的export MY_VAR=value,VSCode默认终端(尤其macOS/Linux)可能根本没执行这些文件——它开的是non-login shell。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r
- 验证方式:在VSCode终端运行
echo $MY_VAR为空,但在iTerm里有输出 → 坐实是shell加载问题 - 解决方法:打开VSCode设置,搜
terminal.integrated.shellArgs,设为["-l"](加-l表示login shell) - Windows用户注意:PowerShell不走
.profile,改用$PROFILE文件写$env:MY_VAR="value",再确保VSCode终端策略允许执行(见下条)
PowerShell执行策略阻止.ps1脚本加载环境变量
Windows上npm全局安装的工具(如cross-env、dotenv-cli)生成的是.ps1脚本,PowerShell默认禁止运行,导致npm run卡在变量加载前就失败。
- 错误典型提示:
"xxx.ps1 cannot be loaded because running scripts is disabled" - 运行
Get-ExecutionPolicy -Scope CurrentUser,若返回Restricted,说明被拦了 - 修复命令(仅当前用户):
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 别用
Unrestricted或-Scope LocalMachine——前者不安全,后者需管理员权限且普通用户终端无法覆盖
跨平台环境变量传递时cross-env参数写法错误
用cross-env本意是统一写法,但参数位置错会导致变量根本没传进脚本。
- 正确写法:
"dev": "cross-env NODE_ENV=development node server.js"—— 变量必须紧挨cross-env,不能塞到后面 - 错误写法:
"dev": "cross-env node server.js NODE_ENV=development"→NODE_ENV成了server.js的argv,不是环境变量 - 多个变量要连写:
cross-env API_URL=https://api.example.com DEBUG=true node app.js - 注意Windows CMD下
%VARIABLE%语法在VSCode PowerShell终端里不生效,必须用cross-env或PowerShell原生$env:VARIABLE="value"
真正卡住人的往往不是.env文件内容,而是VSCode终端启动那一刻到底继承了哪些上下文——PowerShell策略、shell是否login、npm run的进程层级,三者缺一不可。改完任一配置,都得关掉所有VSCode终端窗口再新开,否则旧环境还在缓存里。










