如何在 VSCode 中配置 Node 环境并运行首个 JS 脚本-VSCode-PHP中文网

能跑 node -v 是唯一前提，其他所有操作都建立在这一步之上；没通过就别点 f5、别配 launch.json、也别信插件能“补救”。

如何在 vscode 中配置 node 环境并运行首个 js 脚本

能跑 node -v 是唯一前提，其他所有操作都建立在这一步之上；没通过就别点 F5、别配 launch.json、也别信插件能“补救”。

VSCode 的终端和调试器都靠系统 PATH 找 node，不是靠插件或设置。很多人在系统终端里能跑 node -v，但在 VSCode 内置终端（Ctrl + `）里报 'node' is not recognized，本质是环境变量没继承过去。

Windows：重装 Node.js 时必须勾选 Add to PATH；安装后打开“系统属性 → 环境变量”，确认 C:\Program Files\nodejs\ 已加进“系统变量”的 PATH；改完要彻底退出 VSCode（不是关终端），再重新打开
macOS/Linux：从 Dock 或 Spotlight 启动 VSCode 不会加载 ~/.zshrc；改完 export PATH="...:$PATH" 后只 source ~/.zshrc 不够，必须重启 VSCode，或者直接在终端执行 code . 启动项目
路径别含中文或空格：比如 C:\我的软件\nodejs 或 /Users/张三/node 容易导致 npm 静默失败，优先用 C:\Program Files\nodejs 或 /usr/local/bin/node

别急着右键“Run Code”或点 F5，先确保脚本能被 node 直接执行。VSCode 内置终端就是你的命令行界面，它最真实反映环境状态。

提供端到端的高端代理设置和使用指导，包括代理类型选择、地区定向、访问配置、API密钥验证和监控。

下载

新建文件，保存为 hello.js（扩展名不能漏），内容只写一行：console.log("Hello World");
在 VSCode 内置终端执行：node hello.js；看到输出即表示 JS 运行时工作正常
避免用插件快捷方式（如右键“Run Code”）——初期容易掩盖路径或权限问题，坚持手敲 node 命令更可控
临时测试建议用 require()，不用 import；ESM 支持需要 package.json 里有 "type": "module"，否则直接报错

launch.json 不是万能钥匙，它只认 program 字段指向的真实 JS 文件路径。配错就断点不命中、报 Cannot find module 或 Cannot launch program。

按 Ctrl+Shift+D → 点“创建 launch.json” → 选 Node.js 环境，生成默认配置
"program": "${file}" 适合单文件调试；如果入口是 src/index.js，显式改成 "program": "${workspaceFolder}/src/index.js"
不要手填 runtimeExecutable，除非你明确用 nvm 切版本且需要锁定路径（例如 "runtimeExecutable": "~/.nvm/versions/node/v18.18.2/bin/node"）
TypeScript 或打包项目（Vite/Webpack）：program 必须指向编译后的 .js 文件（如 dist/index.js），不是 .ts 或 .jsx 源码

code-runner 默认命令极简：node $fileName，它不处理编码、模块类型、输入流，也不读 package.json 配置，所以容易出问题。

Windows 中文乱码：在 VSCode 设置中搜 code-runner.executorMap，把 javascript 对应值改成："node -r utf-8 $fileName"
ESM 报 Cannot use import statement outside a module：先确保项目根目录有 package.json 且含 "type": "module"，再把 executor 改成："node --experimental-specifier-resolution=node $fileName"
遇到 process.stdin 就假死：这是 code-runner 的固有限制，它不支持交互式输入；换用内置终端手动运行，或改用调试模式（F5）