VSCode终端node -v报command not found，根本原因是未加载shell配置导致PATH缺失；macOS/Linux需设terminal.integrated.profiles中对应shell的args为["-l"]启用登录shell，Windows应检查系统环境变量PATH是否包含Node.js路径并彻底重启VSCode验证。
VSCode终端里输node -v报command not found怎么办
不是 VSCode 坏了，也不是 Node.js 没装，是终端根本没加载你的 shell 初始化文件（比如 ~/.zshrc 或 ~/.bash_profile），PATH 里压根没有 node 路径。
- 先在系统终端（不是 VSCode 里的）运行
which node（macOS/Linux）或where node（Windows），确认路径真实存在 - macOS/Linux：检查该路径是否已写进
~/.zshrc的export PATH="...:$PATH"行；没写就补上，然后保存 - Windows：打开“系统属性 → 高级 → 环境变量”，在“系统变量”中找到
PATH，确认C:\Program Files\nodejs\已在里面（注意别漏掉反斜杠） - 改完配置后，必须完全退出 VSCode（关所有窗口），再重新启动——只关终端或 reload window 不管用
为什么node命令能跑，但版本不对（比如还是系统自带的旧版）
常见于用了 nvm 却没激活，或者 nvm 初始化代码没生效。终端里 node 存在，但不是你想要的版本，调试和运行时行为就会错乱。
- 在 VSCode 终端里运行
nvm current和which node，对比输出：如果前者显示v18.18.2，后者却是/usr/bin/node，说明nvm没生效 - 检查
~/.zshrc（或对应 shell 配置文件）是否包含完整初始化段：export NVM_DIR="$HOME/.nvm"和[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" - 加完后保存，重启 VSCode；不要只
source ~/.zshrc，集成终端不继承临时 source 的结果 - Windows 上若用 PowerShell，还要额外处理执行策略：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，否则nvm.ps1直接被拦截
terminal.integrated.profiles 怎么配才让终端自动加载 PATH
VSCode 默认以非登录 shell 启动终端，跳过 ~/.zshrc 加载。加 "args": ["-l"] 是唯一可靠方式，告诉 shell “我是登录态”，必须读配置文件。
- 打开 VSCode 设置，搜
terminal.integrated.profiles，点“在 settings.json 中编辑” - 找到你当前默认 shell 的配置块（如
"zsh"或"powershell"），加上"args": ["-l"] - 示例（macOS zsh）：
"zsh": { "path": "zsh", "args": ["-l"] } - Windows PowerShell 若坚持使用，也要加
"args": ["-NoExit", "-Command", "Import-Module posh-git; . $PROFILE"]，但更推荐切到Command Prompt避开策略限制 - 改完保存，彻底重启 VSCode——这个动作不能省，否则 profile 不重载
别用 code-runner 当主力运行器
它绕过项目上下文，不读 package.json 的 "type": "module"，也不处理 process.stdin，出问题时连错误都藏得深。
- 单文件快速验证可以留着，但正式开发一律用内置终端（
Ctrl + `）手动执行node index.js - ESM 项目必须确保
package.json有"type": "module"，否则import报错跟code-runner无关，是 Node.js 解析规则本身 - 需要交互输入的脚本（比如
readline），code-runner必然卡死，只能靠终端或 F5 调试 - 如果非要改
code-runner.executorMap，JavaScript 对应值至少得是："node --experimental-specifier-resolution=node -r utf-8 $fileName"（Windows 加-r utf-8，macOS/Linux 通常不需要）
最常被忽略的是：改完 shell 配置、PATH 或 nvm 初始化代码后，不彻底重启 VSCode，所有改动都白做。
