vscode不自带node.js和git,需系统已安装并正确配置路径;验证须在内置终端执行node -v、npm -v、git --version,失败则检查环境变量、shell类型(powershell需调执行策略,nvm用户推荐git bash)、git.path设置及彻底重启vscode。

VSCode 本身不自带 Node.js 运行时,必须依赖系统已安装的 node 和 npm;Git 同理——VSCode 只是调用你本地装好的 git 命令,不会帮你装或自动配置路径。所以“配置”本质是两件事:确认工具已装好 + 让 VSCode 找得到它们。
检查 node 和 git 是否真可用
别信安装程序说的“完成”,得在终端里亲手验证:
- 打开 VSCode 内置终端(
Ctrl+`),输入node -v和npm -v,必须能立刻输出版本号(如v20.15.0);如果报'node' is not recognized,说明环境变量没生效,重启 VSCode 或重新登录 Windows 用户再试 - 同样输
git --version,看到类似git version 2.45.1.windows.1才算到位;若提示命令不存在,检查 Git 安装时是否勾选了 “Add Git to the system PATH”(Windows 安装器里默认是勾选的,但有时被手动取消) - 特别注意 PowerShell 下的
npm报错:常见错误是The term 'npm' is not recognized as the name of a cmdlet,这通常是因为 Windows 系统策略阻止了脚本执行,不是 npm 没装。临时解决:在 PowerShell 里运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser(仅当前用户)
VSCode 终端默认用 Bash 还是 PowerShell?
Git for Windows 自带 bash.exe,很多前端开发者倾向用它替代 PowerShell,因为命令兼容性更好(尤其涉及 shell 脚本、nvm 切换等)。但 VSCode 默认终端可能是 PowerShell:
- 按
Ctrl+Shift+P打开命令面板,搜Terminal: Select Default Profile - 从列表里选
Git Bash(路径通常是C:Program FilesGitinash.exe或C:Users{user}AppDataLocalProgramsGitinash.exe) - 如果列表里没有 Git Bash,说明 VSCode 没检测到——这时手动编辑
settings.json,加一行:"terminal.integrated.defaultProfile.windows": "Git Bash" - 改完后新开终端,左下角应显示
bash而非PowerShell;此时node和git命令才真正跑在同一套 shell 环境里
nvm 用户必须在 Bash 里激活 Node 版本
如果你用 nvm 管理多个 Node 版本(比如项目要求 v18.20.2,而全局是 v20),PowerShell 无法识别 nvm use 命令,只有 Git Bash 支持:
- 确保
nvm已正确安装(nvm --version有输出) - 在 Bash 终端里运行
nvm list查看已安装版本,再用nvm use 18.20.2切换 - 切换后立即验证:
node -v必须返回你刚指定的版本号;否则 VSCode 的调试器、任务、扩展(如 ESLint)仍会用错版本 - 注意:每次新开终端都要重执行
nvm use,除非你在~/.bashrc里加了nvm use --silent v18.20.2
VSCode 内置 Git 面板依赖 git.path 配置
VSCode 的源代码管理视图(左侧图标 Ctrl+Shift+G)默认会找系统 PATH 里的 git,但有时它找不到,尤其当你装了多个 Git(比如 GitHub Desktop 自带一个、独立安装一个):
- 打开设置(
Ctrl+,),搜git.path - 点 “Edit in settings.json”,手动指定完整路径,例如:
"git.path": "C:\Program Files\Git\cmd\git.exe" - 路径必须指向
git.exe(不是bash.exe),且反斜杠要双写(\) - 改完保存,重启 VSCode —— 如果状态栏左下角出现分支名(如
main),且右上角有 “同步更改” 按钮,说明 Git 集成已就位
最关键的细节往往藏在路径和 shell 类型里:node 在 PowerShell 里能跑,不代表 nvm 能切版本;git 在 CMD 里能提交,不代表 VSCode 的图形化 Git 面板能识别它。别跳过验证步骤,每个 node -v 和 git --version 都得亲手敲一遍。











