Windows 上准备 Node.js、Git 和 VS Code
这篇教程的明确任务是:在 Windows 上完成 Node.js、Git、VS Code 的安装,并用 PowerShell 验证它们可以支持后续 AI 编程和 API 项目。
安装目标
Node.js · Git · VS Code · PowerShell
明确任务
完成后,你应该能在 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 时,不要把密钥写进前端代码、截图、公开仓库或聊天记录。
相关教程
如何在 macOS 上准备 Node.js、Git 和 VS Code
在 macOS 上安装 Node.js、Git 和 VS Code,并用终端验证版本,为后续 AI 编程和 API 项目准备基础环境。
OpenAI API Key 申请与配置教程
理解 API Key 的用途、环境变量配置方式,以及如何避免把密钥暴露到前端。
VS Code 接入 Codex 教程
从安装 Codex 扩展、登录 OpenAI 或 ChatGPT 账号、打开 demo 项目,到第一次让 Codex Agent 规划、执行和验证任务。
如何在 VS Code 中接入谷歌 AI
用 Gemini Code Assist 扩展把 Google AI 接入 VS Code,并说明什么时候需要再配置 Gemini API Key。