vscode内置终端执行node -v报错，本质是环境变量未被继承，需先确保node命令在终端中可识别：macos/linux检查which node并配置到~/.zshrc；windows确认系统path含c:\program files\nodejs\且无空格/中文，重装lts版并勾选“add to path”，最后彻底重启vscode验证。
VSCode内置终端执行node -v报错，说明环境根本没通
所有后续配置都建立在node命令能被VSCode识别的基础上。如果在内置终端（Ctrl + `）里输node -v提示“command not found”，别急着配launch.json或插件——这是环境变量继承失败，不是调试配置问题。
- macOS/Linux：检查
which node输出路径（比如/opt/homebrew/bin/node），确认该路径已写进~/.zshrc或~/.bash_profile的export PATH="...:$PATH"中；改完必须彻底关闭所有VSCode窗口，再从终端运行code --no-sandbox .启动 - Windows：打开「系统属性 → 高级 → 环境变量」，在「系统变量」的
Path里确认存在C:\Program Files\nodejs\；路径含空格或中文（如C:\Program Files (x86)\nodejs）会导致失效，建议重装LTS版并勾选“Add to PATH” - 验证唯一标准：VSCode内置终端里
node -v和npm -v都有输出，且版本号一致
launch.json里program字段填错，断点直接不生效
program不是随便指向一个.js文件就行。它必须是node能直接执行的、已编译/未转译的JS文件路径，否则调试器找不到入口，报错Cannot launch program because corresponding JavaScript cannot be found。
- TypeScript项目：别写
"program": "${workspaceFolder}/src/index.ts"——ts文件不能直接运行；确保tsconfig.json里"sourceMap": true，然后指向编译后的dist/index.js - ES Module项目：若
package.json有"type": "module"，program指向的文件扩展名必须是.mjs，或显式加--experimental-specifier-resolution=node参数 - 常见错误写法：
"program": "${file}"——只适合单文件临时调试；正式项目务必写死路径，比如"program": "${workspaceFolder}/app.js"或"program": "${workspaceFolder}/bin/www"
需要传NODE_ENV或自定义参数，必须用env和args分开配
env和args作用完全不同，混用会失效。环境变量走env对象，命令行参数走args数组，两者不能合并到一起。
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 设环境变量：
"env": {"NODE_ENV": "development", "PORT": "3001"}，这些会在process.env里可用 - 传node运行参数：
"args": ["--trace-warnings", "--max-old-space-size=4096"]，等价于终端里node --trace-warnings --max-old-space-size=4096 app.js - 想让
console.log(process.execPath)和调试器实际调用的node路径一致？必须同时配runtimeExecutable（比如"runtimeExecutable": "/usr/local/bin/node"），否则VSCode可能从PATH里找错版本
code-runner插件跑ESM或中文路径就崩，别依赖它启动
code-runner默认命令太简陋，不处理模块类型、编码、输入流，真实开发中容易掩盖问题。它适合单文件快速验证，但不该成为主力运行方式。
- Windows中文乱码：在设置里搜
code-runner.executorMap，把javascript值改成"node -r utf-8 $fileName" - ESM报
Cannot use import statement outside a module：先确认package.json有"type": "module"，再把executor改成"node --experimental-specifier-resolution=node $fileName" - 只要脚本里有
process.stdin.on('data', ...)，code-runner必然卡死——它不提供stdin输入通道；换用内置终端手动执行，或用F5调试模式
最易被忽略的一点：terminal.integrated.env.*和launch.json里的runtimeExecutable是两套独立逻辑。前者只影响终端命令，后者只影响调试器。改了其中一个，另一个不会自动同步。
