如何在VSCode中排查Node环境未注入NODE_PATH环境变量的模块缺失-VSCode-PHP中文网

vscode终端import报错是因为node_path未被继承，需在terminal.integrated.env.*或launch.json的env中显式配置绝对路径，且nvm用户应避免硬编码版本号，改用软链接或动态路径。

如何在vscode中排查node环境未注入node_path环境变量的模块缺失

VSCode终端里import报错但node -v正常？先确认NODE_PATH是否真被读取

根本不是Node没装好，而是VSCode启动时压根没加载你shell里export的NODE_PATH——它只继承PATH，不自动继承NODE_PATH。验证方法：在VSCode集成终端执行echo $NODE_PATH（macOS/Linux）或echo %NODE_PATH%（Windows），如果输出为空，说明环境变量根本没传进来。

terminal.integrated.env.*配置必须显式声明NODE_PATH

VSCode的终端和调试器都不读取shell初始化文件里的NODE_PATH，必须手动喂进去。不同平台写法有差异：

macOS/Linux："terminal.integrated.env.linux" 或 "terminal.integrated.env.osx" 里加 "NODE_PATH": "/path/to/your/node_modules"
Windows："terminal.integrated.env.windows" 里写 "NODE_PATH": "C:\path\to\node_modules"，注意双反斜杠或正斜杠均可，但不能用单反斜杠
${env:NODE_PATH}不能用在env字段里——它只支持${env:PATH}，NODE_PATH必须硬编码或用绝对路径

launch.json调试时模块仍找不到？env字段要单独配

终端能跑 ≠ 调试器能用。launch.json启动的是全新进程，完全不继承终端的NODE_PATH。必须在configurations里显式写：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

{
  "configurations": [{
    "name": "Launch",
    "type": "pwa-node",
    "request": "launch",
    "program": "${workspaceFolder}/index.js",
    "env": {
      "NODE_PATH": "/absolute/path/to/node_modules"
    }
  }]
}

注意：env必须嵌套在单个configuration对象内，写在外层无效；Windows路径用分号;拼接其他变量时，NODE_PATH仍需独立字段，不能塞进PATH里。

用了nvm或fnm？NODE_PATH别指向全局node_modules

nvm管理的Node版本各自带独立node_modules，但NODE_PATH若指向~/.nvm/versions/node/v18.17.0/lib/node_modules这类路径，容易因版本切换失效。更稳的做法是：

在项目根目录建node_modules软链接：ln -s ~/.nvm/versions/node/$(nvm current)/lib/node_modules ./node_modules（macOS/Linux）
或直接在launch.json里用env动态拼接："NODE_PATH": "${env:HOME}/.nvm/versions/node/v18.17.0/lib/node_modules"
避免把NODE_PATH设为node_modules子目录（如./node_modules/axios），Node只认顶层node_modules路径