明确任务

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

准备工作

Node.js 官方下载

优先选择 macOS LTS 版本

Git macOS 下载

可用官方说明或 Xcode Command Line Tools

Visual Studio Code

选择 macOS 安装包

Step 01

安装 Node.js

打开 Node.js 官方下载页，选择 macOS 版本的 LTS 安装包。安装完成后重新打开 Terminal，确认 node 和 npm 命令可以使用。

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

Step 02

安装 Git

macOS 可以通过 Xcode Command Line Tools 提供 Git，也可以按照 Git 官方 macOS 下载页的说明安装。新手优先用 xcode-select --install 完成基础命令行工具安装。

打开 Terminal
运行 xcode-select --install
按系统提示完成安装

Step 03

安装 VS Code

打开 VS Code 官方下载页，下载 macOS 版本。解压后把 Visual Studio Code 拖进 Applications 文件夹，之后从应用程序里打开。

只从 code.visualstudio.com 下载
拖入 Applications 文件夹
首次打开时确认系统安全提示

Step 04

创建并打开一个 demo 文件夹

在桌面或工作目录中新建一个空文件夹，例如 ai-demo。可以从 VS Code 的 Open Folder 打开，也可以先在 VS Code 命令面板安装 code 命令后，在 Terminal 中执行 code .。

VS Code 能看到左侧文件树
Terminal 可以进入项目目录
需要时安装 Shell Command: code

示例 Prompt

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

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

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

截图清单

Node.js 下载页中选择 macOS LTS 安装包
xcode-select --install 或 Git 安装完成提示
VS Code 左侧文件树打开 demo 文件夹
Terminal 中四条验证命令的输出

验证方式

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

node -vnpm -vgit --versioncode --version

风险提醒

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

如果 macOS 提示应用来自互联网，确认来源是 code.visualstudio.com 后再打开。不要绕过来源不明应用的安全提示。

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

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