Windows 平台安装 Node.js

本文介绍如何在 Windows 系统上安装 Node.js 运行环境。Node.js 是使用 AI 编程工具的必备基础环境。

步骤一：下载安装包

打开浏览器，访问 Node.js 官方网站：

https://nodejs.org/

在首页你会看到两个版本按钮，请认准 **LTS（长期支持版）** 版本进行下载。LTS 版本最稳定，适合日常开发使用。

点击 LTS 按钮后，会自动下载一个 `.msi` 安装文件。

**💡 提示** 建议下载 **LTS** 版本而非 Current 版本。LTS 版本经过了更充分的测试，稳定性和兼容性更好。

## 步骤二：运行安装程序
双击下载好的 `.msi` 文件，启动安装向导：

- 点击 **Next** 继续

- 阅读并接受许可协议，点击 **Next**

- 保持默认安装路径（通常为 `C:\Program Files\nodejs\`），点击 **Next**

- 在自定义安装页面，确保勾选了以下选项：

`Node.js runtime`

- `npm package manager`

- **Add to PATH**（重要：将 Node.js 添加到系统环境变量）

- 点击 **Install** 开始安装，等待完成后点击 **Finish**

[截图：Node.js 安装向导界面]

## 步骤三：验证安装
安装完成后，按下 `Win + R`，输入 `cmd` 并回车，打开命令提示符。依次运行以下命令验证安装：

### 检查 Node.js 版本

node -v

如果安装成功，你会看到类似 v20.x.x 的版本号输出。

检查 npm 版本

npm -v

npm 是 Node.js 的包管理器，正常情况下会同时安装。你应该能看到类似 `10.x.x` 的版本号。

[截图：cmd 中 node -v 和 npm -v 的输出]

## 常见问题

### node 命令未找到
如果运行 `node -v` 提示"不是内部或外部命令"，说明环境变量未正确配置。请尝试：

- 关闭所有命令提示符窗口，重新打开一个新的

- 如果仍然无效，重新运行安装程序，选择 **Repair** 修复安装

- 手动将 `C:\Program Files\nodejs\` 添加到系统 PATH 环境变量

### 安装后需要重启吗？
通常情况下不需要重启电脑。但如果某些终端（如 PowerShell、Git Bash）无法识别 `node` 命令，尝试关闭并重新打开终端即可。

**🚀 下一步** Node.js 安装完成后，你可以前往「macOS 平台」了解其他系统的安装方式，或直接前往「CC-Switch」工具页面进行快速配置。