Cabokit LogoCabokitAITutorial
入门
Windows Dev Environment

Windows 上准备 Node.js、Git 和 VS Code

这篇教程的明确任务是:在 Windows 上完成 Node.js、Git、VS Code 的安装,并用 PowerShell 验证它们可以支持后续 AI 编程和 API 项目。

12 分钟更新于 2026-04-27 16:00Cabokit

安装目标

Node.js · Git · VS Code · PowerShell

1下载安装到位
2终端命令可用
3VS Code 能打开项目
4后续 AI 教程可继续

明确任务

完成后,你应该能在 PowerShell 里运行 Node.js、npm 和 Git 命令,并能用 VS Code 打开一个项目文件夹。这是使用 Codex、Cursor、Gemini Code Assist 或 OpenAI API 教程前最基础的本地环境。

准备工作

Step 01

安装 Node.js

打开 Node.js 官方下载页,选择 Windows 版本的 LTS 安装包。安装过程中保持默认选项即可,重点是确保 npm 会一起安装。

  • 只从 nodejs.org 下载
  • 选择 LTS 版本
  • 安装完成后重新打开 PowerShell

Step 02

安装 Git for Windows

打开 Git 官方 Windows 下载页,下载安装包。新手可以保留默认配置,编辑器选项之后会使用 VS Code,不需要在这里纠结。

  • 只从 git-scm.com 下载
  • 保留默认 PATH 配置
  • 安装完成后重新打开 PowerShell

Step 03

安装 VS Code

打开 VS Code 官方下载页,安装 Windows 版本。建议勾选添加到 PATH 和右键菜单,后续可以更方便地从文件夹打开项目。

  • 安装 User Installer 或 System Installer 均可
  • 建议勾选 Add to PATH
  • 建议勾选 Open with Code

Step 04

创建并打开一个 demo 文件夹

在桌面或工作目录中新建一个空文件夹,例如 ai-demo。右键用 VS Code 打开,或者在 PowerShell 进入该目录后执行 code .。

  • 文件夹路径不要包含过多特殊字符
  • VS Code 能看到左侧文件树
  • 终端可以在项目目录中打开

示例 Prompt

我刚在 Windows 上安装了 Node.js、Git 和 VS Code。请根据我提供的终端输出,判断环境是否准备完成,并指出还缺什么。

请帮我设计一个最小 demo 项目,用来验证 Node.js、npm、Git 和 VS Code 都能正常工作。先给计划,不要直接生成大量代码。

我在 Windows PowerShell 里运行命令报错了。请根据错误信息解释原因,并给出优先级最高的 3 个排查步骤。

截图清单

  • Node.js 下载页中选择 LTS Windows 安装包
  • Git for Windows 安装完成页
  • VS Code 左侧文件树打开 demo 文件夹
  • PowerShell 中四条验证命令的输出

验证方式

重新打开 PowerShell,依次运行下面的命令。每条命令都能输出版本号,就说明基础环境已经准备好。

node -vnpm -vgit --versioncode --version

风险提醒

不要从搜索广告、网盘或第三方下载站安装开发工具。Node.js、Git 和 VS Code 都应该从官方入口下载。

如果命令无法识别,先关闭并重新打开 PowerShell。仍然失败时,再检查安装时是否添加到了 PATH。

后续配置 API Key 时,不要把密钥写进前端代码、截图、公开仓库或聊天记录。

相关教程