VSCode与Node.js深度整合：从安装到上线配置-VSCode-PHP中文网

vscode调试失败的根本原因是调试配置缺失或路径不匹配；需确保launch.json正确配置type、request和runtimeexecutable，并验证终端path继承与项目根目录打开方式。

vscode与node.js深度整合：从安装到上线配置

VSCode 和 Node.js 能无缝协作，但默认安装后直接写 app.js 并按 F5 调试大概率失败——根本原因不是环境没装好，而是调试配置缺失或路径不匹配。

node -v 能用但 VSCode 里 node app.js 报错：检查终端 Shell 和工作区路径

常见现象是命令行输入 node -v 正常，但在 VSCode 内置终端执行 node app.js 却提示 command not found 或 Cannot find module。这不是 Node 没装好，而是 VSCode 终端没继承系统 PATH，或当前打开的文件夹不是项目根目录。

确认 VSCode 内置终端使用的 Shell：Windows 默认是 PowerShell，它可能未加载 Node 的 PATH（尤其手动改过 npm 全局路径时）；可在终端右上角下拉菜单切换为 Command Prompt 或 Git Bash
务必通过 File → Open Folder 打开整个项目文件夹，而不是单个 .js 文件——否则 node_modules 和 package.json 不会被识别
在终端里执行 where node（Windows）或 which node（macOS/Linux），对比命令行和 VSCode 终端输出是否一致；不一致说明 Shell 环境隔离了

launch.json 配置错误导致 F5 启动失败：别照抄模板

VSCode 调试依赖 .vscode/launch.json，但自动生成的模板常含过时字段（如 outFiles）或路径硬编码，一运行就报 Cannot launch program; the specified configuration is invalid。

Rydberg Agent Node

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

下载

最简可用配置只保留这三项：type: "pwa-node"（新版推荐）、request: "launch"、runtimeExecutable: "${env:USERPROFILE}\AppData\Roaming\npm\node.exe"（Windows 全局安装路径）或 "${workspaceFolder}/node_modules/.bin/node"（项目本地安装）
删掉所有 outFiles、sourceMaps、preLaunchTask 字段，除非你真在用 TypeScript 或 Webpack
如果项目用了 nodemon，不要在 launch.json 里写 nodemon app.js —— 改用 runtimeArgs："runtimeArgs": ["-r", "ts-node/register", "app.ts"]（TS 场景）或直接用 tasks.json 启动

npm 全局模块在 VSCode 里找不到：PATH 和权限双坑

执行 npm install express -g 成功，但 require('express') 仍报错 Cannot find module 'express'。这是因为全局安装的模块不会自动加入项目 node_modules，且 VSCode 可能无法读取管理员级安装路径。

全局模块仅用于 CLI 工具（如 http-server、json-server），绝不用于 require() —— 项目依赖必须走 npm install express（无 -g）
若坚持用全局 Express 启动服务，需在 launch.json 中显式指定 runtimeExecutable，指向全局 node.exe，并确保 env 包含完整 PATH（"env": {"PATH": "${env:PATH}"} ）
Windows 上用管理员身份运行 VSCode 才能访问 C:Program Files odejs 下的全局 bin，普通用户启动的 VSCode 会 fallback 到 %APPDATA% pm，路径不同

上线前忽略的环境差异：process.env.NODE_ENV 和 package.json scripts

本地 npm start 正常，部署到服务器后崩溃，错误日志里反复出现 Cannot find module 'dotenv' 或 PORT undefined。问题不在代码，而在执行上下文和脚本定义。

process.env.NODE_ENV 在 VSCode 调试中默认是 undefined，不是 development；必须在 launch.json 的 env 字段里手动设："env": {"NODE_ENV": "development"}
package.json 中的 scripts 是上线唯一可信入口，VSCode 调试不应绕过它；把启动命令写进 "start": "node app.js"，再在 launch.json 里用 runtimeExecutable 指向 npm，args 设为 ["start"]
生产环境严禁依赖 devDependencies（如 nodemon、eslint），部署时用 npm install --production，确保 node_modules 里只有 dependencies