VSCode中‘Launch via NPM’配置失效问题排查求助

我来帮你梳理下这个问题的核心原因，以及对应的解决办法：

问题根源 #

当你使用「Launch via NPM」配置启动项目时，VS Code实际是先启动了npm start进程，然后由npm start再启动node --inspect server.js这个子进程。而你在launch.json里配置的envFile，是给npm进程本身设置环境变量的，但npm默认不会把这些环境变量传递给它启动的node子进程——这就是为什么server.js里拿不到NODE_ENV。

而「Launch Program」配置是直接启动node进程，envFile的配置直接作用于这个node进程，所以能正常读取到dev。

另外还要提一句：你的.env文件里写的NODE_ENV='dev'格式有问题，单引号会被当成变量值的一部分（比如实际拿到的是'dev'而不是dev），应该改成NODE_ENV=dev（去掉单引号）。

解决方案 #

下面给你三种可行的解决办法，选适合你的就行：

方案一：让Node进程主动加载.env文件（最通用） #

用dotenv包让server.js自己读取.env文件，不管启动方式是什么都能生效：

1. 安装依赖：

   npm install dotenv --save-dev
   

2. 在server.js的最顶部添加代码：

   require('dotenv').config()
   

方案二：修改npm脚本，启动时加载.env #

用dotenv-cli工具在npm启动node时自动加载.env文件，不需要修改server.js：

1. 安装依赖：

   npm install dotenv-cli --save-dev
   

2. 修改package.json里的start脚本：

   "start": "dotenv-cli node --inspect server.js"
   

方案三：修改launch.json，强制传递环境变量 #

直接在launch.json的「Launch via NPM」配置里添加env项，把环境变量传递给npm的子进程：

{
  "type": "node",
  "request": "launch",
  "name": "Launch via NPM",
  "runtimeExecutable": "npm",
  "runtimeArgs": ["start"],
  "env": {
    "NODE_ENV": "dev"
  }
}

这种方法不需要额外安装包，但环境变量是硬编码在launch.json里的，不如用.env文件灵活。

内容的提问来源于stack exchange，提问作者Tenshock