VSCode本身不运行JavaScript，所有调试依赖外部运行时：网页项目需Chrome+Live Server，Node.js脚本直接右键“Debug Script”或配置pwa-node；内置JavaScript Debugger已默认启用，无需额外插件。
VSCode 本身不自带 Node.js，所谓“安装 Node.js 环境”，本质是让 VSCode 能正确调用系统已安装的 node 和 npm，并支持调试、运行、智能提示等开发流程。只要终端里能执行 node -v，VSCode 就大概率能用——但实际常卡在“能跑命令却跑不了脚本”这一步。
终端里 node -v 正常，但 VSCode 集成终端报 command not found: node
这不是 VSCode 设置问题，而是它启动时没加载 shell 的初始化文件（比如 ~/.zshrc 或 PATH 没导出）。macOS/Linux 用户尤其容易踩这个坑。
- 检查
~/.zshrc（或~/.bash_profile）是否包含类似export PATH="/usr/local/bin:$PATH"——Homebrew 安装的 Node 默认路径是/usr/local/bin - Windows 用户确认安装 Node.js 时勾选了 “Add to PATH”，否则手动把
C:\Program Files\nodejs\加进系统环境变量 - 改完配置后，别只在终端里 source 一下就完事：必须彻底关闭所有 VSCode 窗口，再从命令行用
code --no-sandbox（macOS）或双击图标（Windows）重启，否则仍继承旧环境
用 code-runner 插件运行 JS 文件却卡住或输出乱码
code-runner 默认直接调 node $fileName，对 ES Module、中文路径、process.stdin 等场景完全不兼容。
- 若用
import语法，需在设置里改code-runner.executorMap中的javascript项为：node --experimental-specifier-resolution=node $fileName - Windows 下中文输出乱码，加
-r utf-8参数：node -r utf-8 $fileName - 带
readline或process.stdin的交互式脚本，code-runner根本不支持输入——必须切到集成终端手动运行
调试时断点不命中，提示 Cannot launch program because corresponding JavaScript cannot be found
VSCode 的 vscode-js-debug 调试器依赖源映射（source map）或原始入口文件。打包（如 webpack）、TS 编译、甚至用了 import 但没配 type: "module"，都可能导致断点失效。
- 确保项目根目录有
package.json，且含"type": "module"（ESM 场景）或留空（CommonJS） - TS 项目必须生成
.js.map文件，并在tsconfig.json中开启"sourceMap": true - 不要直接调试打包后的
dist/index.js——调试应指向源码（src/index.ts或index.js），靠launch.json的outFiles或sourceMaps映射
真正麻烦的从来不是装软件，而是环境变量加载时机、调试器对模块系统的理解差异、以及插件默认行为和你实际代码的错位。这些地方一不留神，就会花半小时查“为什么我的断点不红”。
