2026-05-13 17:03:56 +08:00
|
|
|
|
# Windows 平台安装 Node.js
|
|
|
|
|
|
|
|
|
|
|
|
**三大 AI 编程工具的必备运行环境**
|
|
|
|
|
|
|
|
|
|
|
|
💡 重要说明
|
|
|
|
|
|
|
|
|
|
|
|
Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 运行环境。 如果您已安装 Node.js 18 或更高版本，可跳过本章节。 验证命令：`node -v`
|
|
|
|
|
|
|
|
|
|
|
|
## 方法一：官方安装包（推荐）
|
|
|
|
|
|
|
|
|
|
|
|
1. 访问 Node.js 官网：<https://nodejs.org/zh-cn/download>
|
|
|
|
|
|
2. 下载 LTS（长期支持）版本的 Windows Installer (.msi)
|
|
|
|
|
|
3. 运行安装包，采用默认配置完成安装
|
|
|
|
|
|
4. 安装程序会自动配置系统 PATH 环境变量
|
|
|
|
|
|
|
2026-05-14 14:17:04 +08:00
|
|
|
|
|
2026-05-13 17:03:56 +08:00
|
|
|
|
|
|
|
|
|
|
## 方法二：包管理器安装
|
|
|
|
|
|
|
|
|
|
|
|
### 使用 Winget
|
|
|
|
|
|
|
|
|
|
|
|
Windows 11 或 Windows 10 最新版：
|
|
|
|
|
|
|
|
|
|
|
|
powershell
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
winget install OpenJS.NodeJS.LTS
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
|
|
|
|
|
|
### 使用 Chocolatey
|
|
|
|
|
|
|
|
|
|
|
|
需先安装 Chocolatey：
|
|
|
|
|
|
|
|
|
|
|
|
powershell
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
choco install nodejs-lts
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
|
|
|
|
|
|
### 使用 Scoop
|
|
|
|
|
|
|
|
|
|
|
|
powershell
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
scoop install nodejs-lts
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
|
|
|
|
|
|
## 验证安装
|
|
|
|
|
|
|
|
|
|
|
|
打开命令提示符或 PowerShell，执行：
|
|
|
|
|
|
|
|
|
|
|
|
powershell
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
node --version
|
|
|
|
|
|
npm --version
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
2
|
|
|
|
|
|
|
|
|
|
|
|
如果显示版本号（如 v18.x.x 或更高），说明安装成功。
|
|
|
|
|
|
|
|
|
|
|
|
## 常见问题
|
|
|
|
|
|
|
|
|
|
|
|
### 提示"不是内部或外部命令"
|
|
|
|
|
|
|
|
|
|
|
|
* 重新打开终端窗口
|
|
|
|
|
|
* 检查 PATH 环境变量是否包含 Node.js 路径
|
|
|
|
|
|
* 重启电脑后再试
|
|
|
|
|
|
|
|
|
|
|
|
### 安装失败
|
|
|
|
|
|
|
|
|
|
|
|
* 以管理员身份运行安装程序
|
|
|
|
|
|
* 关闭杀毒软件后重试
|
|
|
|
|
|
* 检查系统盘空间是否充足
|
|
|
|
|
|
|
|
|
|
|
|
## 下一步
|
|
|
|
|
|
|
|
|
|
|
|
✅ 环境准备完成！
|
|
|
|
|
|
|
|
|
|
|
|
现在您可以继续安装 Claude Code、CodeX 或 Gemini CLI 了。
|
|
|
|
|
|
|
|
|
|
|
|
* [返回环境安装总览](</node/windows>)
|
|
|
|
|
|
* [安装 Claude Code](</deploy/claude-code>)
|
|
|
|
|
|
* [使用 CC-Switch 工具](</tools/cc-switch>)
|
