能直接在VSCode内置终端执行node index.js并看到输出才算真正跑起来;若node -v报command not found,说明VSCode未继承系统PATH,需先在系统终端确认which node或where node路径,再通过重启VSCode、配置shellArgs为["-l"](macOS/Linux)或添加PATH到系统环境变量(Windows)解决。

能直接在 VSCode 内置终端里执行 node index.js 并看到输出,才算真正跑起来——不是靠右上角 ▶️ 按钮,也不是靠插件“一键运行”,而是终端原生调用系统 node 命令。
终端里输 node -v 报错:command not found
这不是 VSCode 设置问题,是它根本没继承到你系统里装好的 Node.js 路径。关键不在“装没装”,而在“找不找得到”。
- 先关掉所有 VSCode 窗口(macOS 在 Dock 右键选「退出」,Windows 在任务管理器确认
Code.exe已结束) - 打开系统终端(不是 VSCode 里的),运行
which node(macOS/Linux)或where node(Windows),确认输出的是你安装的路径,比如/usr/local/bin/node或C:\Program Files\nodejs\node.exe - 如果没输出,说明 PATH 没配对:Windows 用户重装 Node.js 并勾选 “Add to PATH”;macOS 用 nvm 的,检查
~/.zshrc是否有source ~/.nvm/nvm.sh,改完要新开终端验证 - 再双击图标重启 VSCode,按
Ctrl+`打开内置终端,立刻跑node -v—— 这次有输出才代表环境就位
node index.js 执行失败:Cannot find module 或 import 错误
常见于 ES Module 场景,Node.js 默认按 CommonJS 解析文件,和 VSCode 无关,是运行时行为。
使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。
- 如果脚本用了
import/export,但没声明模块类型,会报Cannot use import statement outside a module - 两种解法:把文件后缀改成
.mjs(如index.mjs),或在项目根目录package.json中加"type": "module" -
Cannot find module './xxx'多半是当前工作目录不对——VSCode 终端默认以打开的文件夹(workspace root)为起点,不是你正在编辑的文件所在子目录 - 最稳做法:在资源管理器中右键目标 JS 文件 → 「在集成终端中运行」,VSCode 会自动
cd到该目录再执行
调试时断点不命中,或 F5 提示 runtime executable 找不到
VSCode 调试器底层依赖 npm 启动,npm -v 必须成功;同时它可能调用错 Node 版本,尤其你用 nvm 或多个 Node 安装时。
- 确保
npm -v在 VSCode 终端里也有输出,否则断点根本加载不了 - 别只信
launch.json里默认的"program": "${file}",它只适合单文件;跑npm start服务得改成:"program": "npm"、"args": ["start"]、"console": "integratedTerminal" - 多版本共存时,在
launch.json显式指定"runtimeExecutable",例如"runtimeExecutable": "/usr/local/bin/node",避免 PATH 顺序导致调用错版本 - 验证方式:在代码里加
console.log(process.execPath),对比终端输出和调试器里打印的路径是否一致
最易被忽略的一点:VSCode 不是运行环境,它只是个调用器。哪怕装了十个插件,只要系统终端里 which node 都找不到,一切运行和调试都是空转。

















