VSCode怎么配置Node.js作为主开发环境 - 全栈基础建设指南-VSCode-PHP中文网

vscode调试器报“command 'node' not found”是因为gui启动未继承shell path：macos/linux需终端执行code --no-sandbox .启动，windows需安装时勾选“add to path”并验证内置终端node -v和npm -v双输出。

vscode怎么配置node.js作为主开发环境 - 全栈基础建设指南

VSCode 本身不配置 Node.js 环境，它只调用你系统里已装好的 node 和 npm；所谓“配置成功”，就是让终端能跑 node -v、调试器能断点、require() 不报错——三者缺一不可。

这是 Windows/macOS/Linux 上最常被误判为“VSCode 配置问题”的真实故障点：GUI 启动的 VSCode 没继承 shell 的 PATH。

macOS/Linux：从 Dock 或 Spotlight 启动 VSCode，不会加载 ~/.zshrc 或 ~/.bash_profile；改完配置后只 source ~/.zshrc 不够，必须 重启 VSCode，或更可靠地——在终端里执行 code --no-sandbox .
Windows：Node.js 安装时没勾选 “Add to PATH”，或安装路径含中文/空格（如 C:\Program Files\nodejs\ 是合法的，但 C:\我的软件\nodejs\ 会导致 npm 静默失败）
验证方式：在 VSCode 内置终端（Ctrl+`）中直接敲 node -v 和 npm -v，双输出才有继续调试的价值

program 字段不是“随便填个入口文件就行”，它决定调试器真正执行哪段 JS，填错就等于让调试器对着空气下断点。

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

单文件快速调试：用 "program": "${file}" —— 这表示“当前打开的文件”，适合写 demo 或临时脚本
项目级稳定调试：明确指向真实入口，比如 "program": "${workspaceFolder}/dist/index.js"（TS 构建后）或 "program": "${workspaceFolder}/src/index.ts"（配合 sourceMaps 和编译任务）
绝对不要写死路径如 "program": "C:/project/index.js" —— 跨平台失效、团队协作崩盘
调试 npm start？把 "program" 改成 "npm"，再加 "args": ["start"] 和 "console": "integratedTerminal"，否则看不到启动日志

这问题八成和 VSCode 的语言服务有关，跟 node 命令能否运行无关。Node.js 运行时其实已经找到了模块，只是编辑器提示红波浪线、跳转失效、自动补全挂了。

先确认模块真实存在：npm ls <module-name></module-name>，看有没有 extraneous 标记（说明安装异常）
monorepo 场景（如 pnpm workspace）：确保 jsconfig.json 或 tsconfig.json 里有 "baseUrl": "." 和 "paths" 映射
软链接依赖（npm link）：VSCode 默认不跟随 symlink，需在 jsconfig.json 中加 "compilerOptions": { "moduleResolution": "node" }
ESM/CJS 混用：package.json 缺 "type": "module" 时，import 会失败，但 require() 可能正常——别靠报错反推环境问题

这不是代码逻辑问题，是 source map 没对齐或调试器没读到正确映射文件。

TS 项目：确保 tsc --build 生成了 .map 文件，且 launch.json 中启用了 "sourceMaps": true
Webpack/Vite：检查构建配置是否输出 devtool: 'source-map'，并确认 output.path 和 launch.json 中 program 路径一致
常见陷阱：构建产物放在 dist/，但 launch.json 仍指向 src/；或 outDir 设为 ./lib，但 sourceMapPathOverrides 没同步更新
调试器读不到 .map？在 Debug Console 手动执行 console.log(__filename)，比对路径是否和 sources 字段匹配