在VSCode内置终端（Ctrl + `）执行node -v和npm -v是唯一有效检测方式，任一失败则调试、运行、插件均无效；macOS/Linux需确保~/.zshrc加载，Windows须安装时勾选Add to PATH且路径不含空格或中文；terminal.integrated.env.*可注入PATH绕过系统限制，改后须彻底重启VSCode。
在VSCode终端执行node -v和npm -v是唯一有效检测方式
别信“装完就可用”，也别看系统桌面终端能跑就以为VSCode没问题。VSCode内置终端（Ctrl + `）是否识别node，只取决于它启动时继承的PATH——和你手动打开的终端可能完全不同。
- 必须在VSCode内置终端里逐行执行：
node -v、npm -v；任一失败，后续所有调试、运行、插件都无效 - macOS/Linux用户：从Dock或Spotlight启动VSCode时，
~/.zshrc根本没加载，which node输出的路径很可能不在VSCode的PATH里 - Windows用户：安装Node.js时漏选
Add to PATH是最高频原因，哪怕你记得勾选，也可能被杀毒软件或旧版软件覆盖路径 - 路径含空格或中文（如
C:\Program Files\nodejs或D:\开发工具\nodejs）会导致命令解析失败，报'node' is not recognized但不提示具体原因
terminal.integrated.env.*是绕过系统PATH限制的可靠方案
当你无法修改系统环境变量（比如公司电脑权限受限），或需为单项目指定Node版本（如用nvm管理多个版本），就得靠VSCode自己的环境变量注入机制。
- 在项目根目录的
.vscode/settings.json中添加对应平台字段，例如macOS："terminal.integrated.env.osx": { "PATH": "/opt/homebrew/bin:${env:PATH}" } - Linux对应
linux，Windows对应windows；注意斜杠方向统一用/，Windows路径也要写成C:/nodejs而非C:\nodejs - 这个配置不改系统
PATH，而是在终端启动时把指定路径“前置”进去，优先级高于系统原有值 - 改完必须彻底关闭所有VSCode窗口再重开——
Developer: Reload Window不重建进程，PATH不会更新
调试器runtimeExecutable和终端node不是一回事
即使node -v在终端和VSCode里都成功，F5调试仍可能报Cannot find runtime 'node'——因为VSCode调试器默认不走PATH查找，尤其当你用nvm、fnm或volta管理版本时。
- 检查
.vscode/launch.json中是否有runtimeExecutable字段；如果存在且路径写死（如~/.nvm/versions/node/v18.17.0/bin/node），那它就完全绕过PATH - 想让调试器和终端行为一致？删掉
runtimeExecutable这一行，让它按PATH顺序找node - 验证是否生效：在代码里加
console.log(process.execPath)，对比终端运行和F5调试时输出的路径是否一致 - ESM项目还要额外加
"runtimeArgs": ["--experimental-specifier-resolution=node"]，否则import会直接报错
code-runner插件不适合真实开发场景
它快捷键Ctrl+Alt+N适合临时跑单文件，但会绕过项目上下文，导致模块解析、编码、标准输入等全部失真。
- 遇到
Cannot use import statement outside a module？说明code-runner没读package.json里的"type": "module"，强行当CommonJS解析 - Windows下中文乱码？默认没加
-r utf-8，得手动改code-runner.executorMap里javascript的值 -
process.stdin卡死？code-runner不支持交互式输入，必须换用内置终端或F5调试 - 正式开发中建议禁用该插件，用
Ctrl+`手动执行node index.js，行为与部署环境完全一致
Ctrl + `里敲命令，而不是凭记忆或截图判断。 
