vscode 找不到 node 命令是因为环境变量未正确继承：macos/linux 需通过终端启动 vscode 或确保 path 包含 node 路径；windows 需检查 path 是否包含 node.js 安装目录或重装并勾选“add to path”；验证方式为在内置终端执行 node -v 和 npm -v。
VSCode 找不到 node 命令？先确认环境变量是否继承正确
VSCode 本身不带 Node.js 运行时，它只调用系统已安装的 node。如果你在终端里能执行 node -v，但在 VSCode 内置终端（Ctrl+`）里报 command not found: node，问题几乎 100% 出在环境变量没被正确加载。
- macOS/Linux：VSCode 从 Dock 或 Spotlight 启动时，不会读
~/.zshrc或~/.bash_profile。解决办法是——关掉所有 VSCode 实例，然后在终端里运行code --no-sandbox .启动；或者确保which node输出的路径（比如/opt/homebrew/bin/node）已加进 shell 配置文件的PATH，改完后必须重启 VSCode - Windows：安装 Node.js 时没勾选 “Add to PATH” 是最常见原因。打开「系统属性 → 高级 → 环境变量」，检查
C:\Program Files\nodejs\是否出现在“系统变量”或“用户变量”的PATH中；不确定就重装 Node.js，并**务必勾选该选项** - 验证方式：在 VSCode 内置终端中直接运行
node -v和npm -v，有输出才算真正生效
用 npm init 初始化项目前，先检查 package.json 是否必要
不是所有 Node.js 脚本都需要 package.json，但它是现代开发的事实标准——尤其当你用 import、ESM 模块、或依赖第三方包（如 express）时，package.json 就成了必需品。
- 如果只是跑一个单文件 HTTP 服务器（比如
http.createServer），不引入任何 npm 包，你可以跳过npm init，直接node app.js - 但一旦要用
import，就必须在package.json里加"type": "module"，否则会报Cannot use import statement outside a module -
npm init -y可跳过交互式提问，生成最小可用package.json；后续加依赖时，npm install express会自动写入dependencies字段
调试时断点不命中？别急着改代码，先看 launch.json 配置是否匹配运行模式
VSCode 调试器默认按 CommonJS 模式解析 JS 文件。如果你项目启用了 ESM（即写了 import），又没配对，断点就会失效，甚至提示 Cannot launch program because corresponding JavaScript cannot be found。
- 新建调试配置：按
Ctrl+Shift+D→ 点左上角齿轮图标 → 选择Node.js→ 生成.vscode/launch.json - 关键字段：
"type": "pwa-node"（新版推荐）、"request": "launch"、"program": "${file}"（当前文件）或"${workspaceFolder}/app.js"（固定入口） - ESM 项目必须加：
"runtimeArgs": ["--experimental-specifier-resolution=node"]，否则import无法解析 - 不要手动改
outFiles或sourceMaps——除非你真在用 TypeScript 或构建工具生成了.map文件
code-runner 插件跑 Node.js 脚本容易出错，优先用内置终端或调试器
code-runner 默认命令太简单：node $fullFileName，不处理编码、模块类型、输入流，尤其在 Windows 中文路径或 ESM 下极易失败。
- 乱码（Windows）：在设置里搜
code-runner.executorMap，把javascript对应值改成"node -r utf-8 $fileName" - ESM 报错：即使改了 executor，仍不如直接用调试器或内置终端可靠；建议彻底禁用
code-runner对.js的绑定 - 遇到
process.stdin就卡住：这是code-runner的固有限制，它不支持交互式输入；要么换用调试模式（F5），要么在内置终端里手动执行node app.js
真正稳定的组合只有两个：内置终端 + 手动 node 命令，或调试器 + 正确配置的 launch.json。其他捷径看似快，实则埋坑。
