MX
Node.js

Node.js

JavaScript运行环境，前端项目开发必备，内置npm包管理器。

开发环境前端开发
480 浏览89 下载

视频教程

1 个
Node.js下载安装配置视频教程B站打开观看

使用文档

1 篇文档 · 34 个章节

Node.js 下载安装与配置教程

1. Node.js 简介

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，让 JavaScript 可以脱离浏览器在服务器端运行。它采用事件驱动、非阻塞 I/O 模型，轻量且高效。

2. 下载 Node.js

官方下载地址

访问 Node.js 官网：https://nodejs.org/

提供两个版本：

版本 说明
LTS（长期支持版） 稳定性高，适合生产环境，推荐大多数用户使用
Current（最新版） 包含最新特性，适合尝鲜，稳定性略低

💡 推荐下载 LTS 版本，以获得更好的稳定性和长期支持。

下载文件类型说明

文件格式 适用系统 说明
.msi Windows 安装包版，自动配置环境变量，推荐
.zip Windows 压缩包版，免安装，需手动配置
.pkg macOS 安装包版，自动配置环境变量
.tar.gz macOS/Linux 源码压缩包，需编译安装

3. Windows 系统安装

方式一：MSI 安装包（推荐）

  1. 下载 .msi 格式的安装包（选择对应系统位数：x64 / x86）
  2. 双击运行安装程序，点击 Next
  3. 勾选 I accept the terms in the License Agreement，点击 Next
  4. 选择安装路径（默认 C:\Program Files\nodejs\）
  5. 点击 Next 直到安装完成

✅ 安装过程中会自动将 Node.js 添加到系统环境变量 PATH 中，无需手动配置。

方式二：ZIP 压缩包（免安装绿色版）

适用于需要 多版本共存、便携式部署 或 无管理员权限 的场景。

步骤 1：解压到目标目录

将 ZIP 包解压到你想要的目录，例如：

plain
D:\nodejs\

解压后的目录结构示例：

plain
D:\nodejs\
├── node.exe          # Node.js 可执行文件
├── npm.cmd           # npm 命令行工具
├── npx.cmd           # npx 命令行工具
├── node_modules\     # 内置模块
└── ...

步骤 2：配置环境变量（重要！）

① 添加 Node.js 到 PATH

  • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  • 在「系统变量」或「用户变量」中找到 Path，点击「编辑」
  • 点击「新建」，添加 Node.js 解压目录：
plain
D:\nodejs\
  • 点击「确定」保存

② 配置 npm 全局安装路径（可选但推荐）

在 D:\nodejs\ 目录下新建两个文件夹：

plain
D:\nodejs\node_global
D:\nodejs\node_cache

打开 CMD 或 PowerShell，执行：

bash
npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"

③ 将全局路径添加到 PATH

再次进入「环境变量」设置，在 Path 中添加：

plain
D:\nodejs\node_global

④ 配置 NODE_PATH（可选）

在「系统变量」中新建：

plain
变量名：NODE_PATH
变量值：D:\nodejs\node_global\node_modules

步骤 3：验证安装

重新打开 CMD 终端：

bash
node -v
# 输出示例：v20.15.0

npm -v
# 输出示例：10.8.1

ZIP 方式的优缺点

优点 缺点
✅ 免安装，解压即用 ❌ 需手动配置环境变量
✅ 方便多版本共存（解压到不同目录） ❌ 不会自动创建开始菜单快捷方式
✅ 无需管理员权限 ❌ 不会自动关联 .js 文件
✅ 可放在 U 盘便携使用

4. macOS 系统安装

方式一：官方安装包

  1. 下载 .pkg 格式的安装包
  2. 双击运行，按照提示完成安装
  3. 安装程序会自动配置环境变量

方式二：使用 Homebrew（推荐）

bash
# 安装 LTS 版本
brew install node@20

# 或安装最新版
brew install node

# 安装后链接
brew link --overwrite node@20

方式三：使用 nvm（Node 版本管理）

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

# 重启终端后安装 Node
nvm install --lts
nvm use --lts

5. Linux 系统安装

方式一：使用 NodeSource 仓库（推荐）

Ubuntu / Debian：

bash
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

CentOS / RHEL / Fedora：

bash
# 添加 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -

# 安装 Node.js
sudo yum install -y nodejs

方式二：使用 nvm

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

# 重新加载配置
source ~/.bashrc

# 安装 LTS 版本
nvm install --lts
nvm use --lts

方式三：使用包管理器

bash
sudo apt update
sudo apt install nodejs npm  # Ubuntu/Debian

⚠️ 包管理器中的版本可能较旧，不推荐生产环境使用。

6. 环境变量配置（通用详解）

Windows（MSI 安装版）

MSI 安装包会自动配置 PATH，无需手动操作。如需修改 npm 全局路径：

bash
npm config set prefix "C:\Program Files\nodejs\node_global"
npm config set cache "C:\Program Files\nodejs\node_cache"

Windows（ZIP 版）

按照 3. 方式二 中的步骤配置。

macOS / Linux

编辑 shell 配置文件（~/.bashrc、~/.zshrc 或 ~/.profile）：

bash
# 设置 npm 全局安装路径
export NPM_PREFIX=~/.npm-global
mkdir -p $NPM_PREFIX
npm config set prefix $NPM_PREFIX

# 添加到 PATH
export PATH="$NPM_PREFIX/bin:$PATH"

# 加载配置
source ~/.bashrc  # 或 source ~/.zshrc

7. 验证安装

打开终端（命令行），执行以下命令：

bash
# 查看 Node.js 版本
node -v
# 输出示例：v20.15.0

# 查看 npm 版本
npm -v
# 输出示例：10.8.1

# 查看 npx 版本
npx -v
# 输出示例：10.8.1

测试 Hello World

创建 test.js 文件：

javascript
console.log('Hello, Node.js!');

运行：

bash
node test.js
# 输出：Hello, Node.js!

8. npm 配置与加速

查看当前配置

bash
npm config list

更换为国内镜像源（推荐）

淘宝 npm 镜像：

bash
npm config set registry https://registry.npmmirror.com
npm config get registry  # 验证

腾讯云镜像：

bash
npm config set registry https://mirrors.cloud.tencent.com/npm/

使用 cnpm（可选）

bash
npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install express

配置代理（如需）

bash
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

# 取消代理
npm config delete proxy
npm config delete https-proxy

9. 常见问题

Q1：node -v 显示 “command not found”

  • Windows（ZIP 版）：检查环境变量 PATH 是否包含 Node.js 解压目录，需重启终端
  • Windows（MSI 版）：检查是否以管理员权限安装
  • macOS/Linux：检查是否完成安装，或重启终端

Q2：ZIP 版安装后 npm 命令无法使用

确保 npm.cmd 和 node.exe 在同一目录下，且该目录已添加到 PATH 中。

Q3：权限错误（EACCES）

macOS/Linux 解决：

bash
sudo chown -R $(whoami) ~/.npm

Windows 解决：
以管理员身份运行终端。

Q4：npm install 速度慢

更换国内镜像源（见第 8 节）。

Q5：如何切换 Node 版本？

使用 nvm（Node Version Manager）：

bash
nvm install 18.17.0
nvm use 18.17.0
nvm list
nvm alias default 20.15.0

Q6：ZIP 包如何卸载？

直接删除解压出来的文件夹，再清除环境变量中对应的 PATH 条目即可，无残留注册表项。

📚 参考资源

客服
反馈