如何安装 Node.js

本文将带介绍如何在电脑上安装 Node.js 运行环境，从而可以使用丰富的应用 Nodejs 程序。

Windows

测试安装环境为 Windows 11

下载 Node.js

访问 Node.js 的官方网站的 下载页面 下载安装包。

我们选择 预构建安装程序 ，选择一下自己的系统与 CPU 架构类型， Windows 一般选择 x64，再选择 Node.js 版本。

推荐选择版本号为偶数的 LTS 版本

nodejs-home-page

安装 Node.js

然后打开安装程序 node-v22.12.0-x64.msi，安装过程没有陷阱，我们 同意 协议后，一路点击 Next 即可。

nodejs-setup

安装完成后，打开终端程序：

  • 右键点击开始菜单，选择终端
  • 或是按 Windows + R 快捷键打开 运行 窗口，输入 cmd ，回车打开
  • 或是在资源管理器的地址栏中输入 cmd 回车打开（终端的运行目录将是资源管理器所在的目录）

运行下面的命令测试安装结果。

1
node -v
1
npm -v

如果可以成功输出版本号，表示安装成功。

nodejs-install-done

macOS

测试安装环境为 macOS 15.1 ，macOS 更推荐使用 包管理器 Homebrew 进行安装。

Homebrew 是 macOS 和 Linux 缺失软件包的管理器，用于安装 Apple没有预装但你需要的东西。

安装需要使用终端，在 Mac 上打开或退出“终端”：

  • 启动台 > 其他 > 终端
  • 启动台 或是　Commond⌘ + 空格 打开聚焦搜索，搜索 终端 或是 Terminal

安装 Homebrew

中国大陆地区或是更详细步骤请查看：如何在 macOS 中安装 Homebrew

首先复制安装命令 

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

在终端内执行安装命令，安装时需要输入你的电脑密码进行授权： 

1
2
==> Checking for `sudo` access (which may request your password)...
Password:

brew 会提示将安装的软件以及创建的文件夹，按回车继续，等待下载和安装完成。

命令执行结束后按照提示复制执行下面的三条命令添加 PATH :

1
2
3
echo >> /Users/me/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/me/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

如果使用了 oh-my-zsh ，需要执行下面的命令:

1
2
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc   
source ~/.zshrc

然后可以执行 brew -v 测试安装结果，成功会显示 Hombrew 的版本号。 

1
2
>brew -v
Homebrew 4.4.11

安装 Nodejs

打开终端，执行

1
brew install node

测试

1
2
3
4
5
>node -v
v23.4.0

>npm -v
10.9.2

brew 常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 安装指定版本
brew install node@22

# 卸载
brew remove node

# 查看已安装软件
brew list 

# 检查更新
brew update

# 下载更新
brew upgrade

Linux

Linux 使用 nvm 包管理器可以很方便的安装 Node.js

首先安装 nvm

安装 nvm (Node 版本管理器)

1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

更新一下 PATH

1
2
3
4
5
# bash
source ~/.bashrc

# zsh
source ~/.zshrc

验证

1
2
root@debian:~# nvm -v
0.40.1

安装 Node.js

下载并安装 Node.js 22 LTS 版本

1
nvm install 22

验证

1
2
3
4
root@debian:~# node -v
v22.12.0
root@debian:~# npm -v
10.9.0

npm 常用命令

npm 是 Node.js 自带的包管理器是 ，我们可以很方便的安装 Node.js 应用，常用命令介绍：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# 初始化项目，创建 package.json 文件
npm init

# 查看版本
npm -v

# 查看当前 npm 的配
npm config list	

# 更新 npm 到最新版本
npm update -g npm

# 安装项目中的所有依赖项（基于 package.json）
npm i
npm install 

# 安装指定包，并添加到项目依赖
npm install <package>

# 安装指定版本的包，例如：npm i [email protected]
npm install <package>@<version>

# 全局安装指定的包（通常为 CLI 工具） 
npm install <package> -g

# 卸载指定包
npm uninstall <package>

# 更新指定的包到最新版本
npm update <package>

# 查看当前项目已安装的依赖包
npm list

# 查看全局已安装的依赖包
npm list -g

# 移除未在 package.json 中声明的多余依赖包
npm prune

使用 pnpm

如果你需要经常使用 Node.js 应用，更推荐安装 pnpm 包管理，它的性能更好，安装速度速度更快，默认开启严格模式，确保项目中的依赖版本一致，避免了某些隐藏的版本冲突问题，并且对保持对 npm 的兼容。

pnpm 的版本锁定文件是 pnpm-lock.yaml

安装 pnpm

1
npm install -g pnpm

常用命令

pnpm 使用命令与 npm 类似，比如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 基于 pnpm-lock.yaml 安装依赖
pnpm i
pnpm install 

# 查看自身版本
pnpm -v

# 安装单个依赖，使用 pnpm install 也是可以的
pnpm add <package>

# 全局安装
pnpm add -g <package>

# 指定版本
pnpm add <package>

# 删除软件包
pnpm remove <package> 

# 更新自身
pnpm self-update
pnpm add -g pnpm

其他操作

更换镜像源

中国大陆用户可以使用下面的命令切换使用淘宝的镜像源，加速下载

1
npm config set registry https://registry.npm.taobao.org

查看当前的镜像源

1
npm config get registry