本文将带介绍如何在电脑上安装 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