Skip to main content

安装 Node.js

本指南将详细说明如何在 Windows、macOS 和 Linux 操作系统上安装 Node.js 运行时环境。Node.js 是 PCode 运行所需的核心依赖。

版本要求

PCode 推荐使用 Node.js 24+（最低支持 Node.js >= 18.0）。建议安装最新的 LTS 版本以获得最佳性能和安全性。在安装完成后，请验证您的版本满足此要求。

安装 Node.js​

方法一：官方安装包（推荐）​

  1. 访问 Node.js 官方网站
  2. 下载 **LTS（长期支持）**版本的 Windows 安装程序（.msi 文件）
  3. 双击运行安装程序
  4. 按照安装向导的提示完成安装：
    • 接受许可协议
    • 选择安装路径（默认即可）
    • 确保勾选 "Automatically install the necessary tools"（自动安装必要的工具）
    • 点击 "Install" 开始安装
  5. 安装完成后，点击 "Finish"

方法二：使用 winget​

打开 PowerShell 或命令提示符，运行以下命令：

winget install OpenJS.NodeJS.LTS

安装完成后，重新打开终端以使更改生效。

使用版本管理工具​

如果您需要在多个 Node.js 版本之间切换，可以使用版本管理工具。

nvm (Node Version Manager)​

Linux/macOS​

# 使用 curl 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 或使用 wget 安装
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

安装完成后，重新加载您的 shell 配置：

source ~/.bashrc
# 或对于 Zsh 用户
source ~/.zshrc

Windows​

在 Windows 上，推荐使用 nvm-windows：

  1. 从 nvm-windows releases 下载最新的 nvm-setup.exe
  2. 运行安装程序
  3. 重新打开命令提示符或 PowerShell

fnm (Fast Node Manager)​

fnm 是一个更快、更简单的 Node.js 版本管理工具，使用 Rust 构建。

Linux/macOS​

# 使用 curl 安装
curl -fsSL https://fnm.vercel.app/install | bash

# 安装完成后，重新加载 shell 配置
source ~/.bashrc
# 或对于 Zsh 用户
source ~/.zshrc

Windows​

使用 scoop 或 winget：

# 使用 scoop
scoop install fnm

# 或使用 winget
winget install Schniz.fnm

中国大陆用户加速​

如果您在中国大陆地区，下载 Node.js 和 npm 包可能会遇到速度慢的问题。以下是一些加速方案。

使用国内镜像源​

npm 淘宝镜像（推荐）​

# 临时使用淘宝镜像
npm install --registry=https://registry.npmmirror.com

# 永久设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证镜像是否设置成功
npm config get registry

使用 nrm 管理镜像源​

nrm (npm registry manager) 可以帮助您快速切换 npm 镜像源：

# 安装 nrm
npm install -g nrm

# 列出可用的镜像源
nrm ls

# 切换到淘宝镜像
nrm use taobao

# 测试镜像源速度
nrm test

下载 Node.js 安装包加速​

淘宝提供了 Node.js 安装包的镜像下载：

访问以上地址，选择您需要的版本进行下载。

Homebrew 国内镜像​

如果您在中国大陆使用 Homebrew，可以配置国内镜像加速：

# 安装 Homebrew 时使用国内镜像
/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"

# 或使用中科大的镜像
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles

中国大陆特有包管理器​

cnpm​

cnpm 是淘宝团队提供的 npm 客户端，默认使用淘宝镜像：

# 安装 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com

# 使用 cnpm 安装包
cnpm install <package-name>
tip

cnpm 与 npm 命令基本兼容，可以直接替换使用。

验证镜像加速效果​

设置镜像后，可以通过以下命令验证：

# 测试下载速度
time npm install express --registry=https://registry.npmmirror.com

# 对比官方源速度
time npm install express --registry=https://registry.npmjs.org

验证安装​

安装完成后，请验证 Node.js 和 npm 是否正确安装：

# 检查 Node.js 版本
node --version

# 检查 npm 版本
npm --version
info

确保 Node.js 版本 >= 18.0（推荐使用 Node.js 24+）。如果版本过低，请按照上述方法重新安装或使用版本管理工具安装正确的版本。

验证命令输出示例​

成功的验证输出应该类似：

$ node --version
v24.3.0

$ npm --version
10.2.3

故障排除​

Windows 问题​

如果在安装后 node 或 npm 命令不可用：

  1. 重新启动命令提示符或 PowerShell
  2. 如果仍然不可用，手动将 Node.js 添加到 PATH：
    • 搜索 "环境变量" 并打开 "编辑系统环境变量"
    • 点击 "环境变量"
    • 在 "系统变量" 中找到 "Path"，点击 "编辑"
    • 添加 Node.js 的安装路径（默认：C:\Program Files\nodejs\）
    • 点击 "确定" 保存更改

macOS 问题​

如果在安装全局 npm 包时遇到权限错误：

# 修复 npm 权限
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

Linux 问题​

如果在安装全局 npm 包时遇到权限错误，建议使用 Node.js 版本管理工具（如 nvm 或 fnm）而不是系统包管理器。

检查环境​

如果验证失败，检查以下内容：

# 检查 Node.js 是否在 PATH 中
where node

# 检查安装路径
Get-Command node

下一步​

Node.js 安装完成后，返回安装指南继续配置。

需要更多帮助？​

如果您遇到此处未涵盖的问题：

  1. 访问 Node.js 官方文档
  2. 查看 GitHub Issues 寻找类似问题
  3. 访问我们的社区论坛寻求帮助