根本原因是系统未将node加入环境变量且vscode未继承shell初始化后的path；macos/linux需检查~/.zshrc或~/.bash_profile中path导出，windows需确认安装时勾选“add to path”并重启vscode。
VSCode里直接运行JS文件报“command not found: node”
根本原因是系统没把 node 命令加进环境变量，VSCode 启动时没继承到它。不是插件问题，也不是 VSCode 设置不对——你终端里能跑 node -v，但 VSCode 的集成终端或调试器却找不到，大概率是 Shell 初始化逻辑没加载完。
实操建议：
- macOS / Linux：检查
~/.zshrc或~/.bash_profile里是否漏了export PATH="/usr/local/bin:$PATH"（Homebrew 安装的 Node 默认路径） - Windows：确认安装 Node.js 时勾选了 “Add to PATH”，没勾的重装或手动把
C:\Program Files\nodejs\加进系统环境变量 - VSCode 重启前，先关掉所有窗口，再从命令行启动：
code --no-sandbox（macOS）或直接双击图标（Windows），避免继承旧 shell 环境
用 code-runner 插件跑 JS 却输出乱码或卡住
这个插件默认用 node 执行，但没传参、没设编码、也没捕获错误流，遇到中文路径或异步代码容易假死。
实操建议：
- 在 VSCode 设置里搜
code-runner.executorMap，找到javascript对应项，改成："node --experimental-specifier-resolution=node $fileName"（适配 ES Module） - 加
-r utf-8参数防乱码（仅 Windows）："node -r utf-8 $fileName" - 别用它跑带
process.stdin的交互式脚本——code-runner不支持输入，换debugger或终端手动跑
调试时断点不生效，控制台显示“Cannot launch program because corresponding JavaScript cannot be found”
这是 VSCode 的 Node.js 调试器（vscode-js-debug）找不到源映射或入口文件，常见于用 import、TS 编译、或打包后的代码。
实操建议：
- 确保
.vscode/launch.json里program字段指向的是真实可执行的 JS 文件（比如./dist/index.js），不是.ts或.mjs源文件 - 如果用了 TypeScript，必须开启
sourceMaps: true，且编译后.js.map文件和.js在同一目录 - ESM 项目要加
"type": "module"到package.json，否则调试器会按 CJS 解析，路径解析错乱
想快速测试一段代码，又不想建文件、配配置
VSCode 自带的 JavaScript REPL（通过命令面板 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools 不是它；正确路径是 View: Command Palette → JavaScript Debug Terminal）其实更轻量。
实操建议：
- 按
Ctrl+Shift+Y（Windows/Linux）或Cmd+Shift+Y（macOS）打开 debug console，粘贴代码回车就能执行，支持await、变量保留 - 如果想保存片段，用 VSCode 内置的
Untitled-1.js新建空文件，右键 →Run Code（需装code-runner）比新建文件夹快得多 - 注意：REPL 里
__dirname和require不可用，别依赖模块系统
which node 和 VSCode 集成终端的 $PATH 输出，比反复重装插件管用。Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
