# 如何安装 Node.js 与 npm：新手完全指南

> 无论你是刚接触前端开发，还是准备搭建一个个人博客，Node.js 和 npm 都是必不可少的工具。这篇指南会带你从零开始，在三大主流操作系统上完成安装。 Node.js 是一个基于 Chrome V8…

- 原文：https://wanrenhuifu.github.io/blog/how-to-install-npm/
- 发布：2026-05-31
- 部门：技术部
- 标签：Node.js、npm、前端、教程
- 字数：3254
- 许可：https://creativecommons.org/licenses/by-nc-sa/4.0/（署名—非商业性使用—相同方式共享）
- 站点：https://wanrenhuifu.github.io/

---

无论你是刚接触前端开发，还是准备搭建一个个人博客，Node.js 和 npm 都是必不可少的工具。这篇指南会带你从零开始，在三大主流操作系统上完成安装。

## 一、Node.js 与 npm 是什么

**Node.js** 是一个基于 Chrome V8 引擎的 JavaScript 运行时，让你可以在浏览器之外执行 JavaScript 代码。

**npm**（Node Package Manager）是 Node.js 的包管理工具，随 Node.js 一同安装。它让你可以方便地下载、安装和管理项目依赖——比如 React、Vue、Next.js 等框架，都是通过 npm 来安装的。

简单来说：**装 Node.js = 同时装了 npm**。

---

## 二、Windows 安装

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

1. 访问 [Node.js 官网](https://nodejs.org/)
2. 点击首页左侧的 **LTS**（长期支持版）下载按钮
3. 运行下载的 `.msi` 安装程序
4. 一路点击 **Next**，保持默认选项即可
5. 安装完成后，点击 **Finish**

### 方法二：使用包管理器

如果你已经安装了 [Winget](https://docs.microsoft.com/windows/package-manager/winget/)（Windows 10/11 自带），可以在 PowerShell 中运行：

```powershell
winget install OpenJS.NodeJS.LTS
```

或者使用 [Chocolatey](https://chocolatey.org/)：

```powershell
choco install nodejs-lts
```

---

## 三、macOS 安装

### 方法一：官方安装包

1. 访问 [Node.js 官网](https://nodejs.org/)
2. 下载 **LTS** 版本的 `.pkg` 文件
3. 双击运行，按提示完成安装

### 方法二：Homebrew（推荐）

如果你使用 [Homebrew](https://brew.sh/)，一行命令即可：

```bash
brew install node@22
```

> 注意：Homebrew 安装的版本可能较新。如果需要特定版本，可以使用 `brew install node@20` 等形式。

### 方法三：版本管理器 fnm

对于需要在多个 Node.js 版本之间切换的开发者，推荐使用 [fnm](https://github.com/Schniz/fnm)：

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

# 安装并使用最新的 LTS 版本
fnm install --lts
fnm use --lts
```

---

## 四、Linux 安装

### Ubuntu / Debian

```bash
# 更新软件源
sudo apt update

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

# 注意：系统源中的版本可能较旧，建议后续使用 n 或 nvm 升级
```

如需最新版本，可以使用 NodeSource 脚本：

```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
```

### CentOS / RHEL / Fedora

```bash
# 使用 NodeSource
sudo dnf install https://rpm.nodesource.com/pub_22.x/nodistro/repo/nodesource-release-nodistro-1.noarch.rpm
sudo dnf install -y nodejs --setopt=nodesource-nodejs.module_hotfixes=1
```

### Arch Linux

```bash
sudo pacman -S nodejs npm
```

---

## 五、验证安装

打开终端（Windows 使用 PowerShell 或 CMD，macOS/Linux 使用 Terminal），输入以下命令：

```bash
node -v
npm -v
```

如果看到类似下面的输出，说明安装成功：

```
v22.14.0
10.9.2
```

> 版本号可能与你安装时略有不同，只要没有报错即可。

---

## 六、配置国内镜像源（可选）

由于网络原因，国内访问 npm 官方仓库可能较慢。可以配置淘宝镜像源加速下载：

### 临时使用

```bash
npm install <package-name> --registry=https://registry.npmmirror.com
```

### 永久配置

```bash
npm config set registry https://registry.npmmirror.com
```

### 验证配置

```bash
npm config get registry
```

> 如果后续需要恢复到官方源，运行：
> ```bash
> npm config set registry https://registry.npmjs.org/
> ```

---

## 七、常见问题

### 1. `'node' 不是内部或外部命令`

**原因**：Node.js 没有正确添加到系统环境变量。

**解决**：
- Windows：重新安装 Node.js，确保勾选了 "Add to PATH" 选项
- 或手动将 `C:\Program Files\nodejs\` 添加到系统环境变量 Path 中

### 2. `npm install` 速度极慢或超时

**原因**：网络连接 npm 官方仓库不稳定。

**解决**：配置国内镜像源（见上文第六节）。

### 3. `EACCES: permission denied`

**原因**：macOS/Linux 上使用 `sudo npm install -g` 导致权限问题。

**解决**：
- 避免使用 `sudo` 安装全局包
- 或者修改 npm 全局目录的权限：

```bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
```

### 4. 如何升级 npm

```bash
npm install -g npm@latest
```

---

## 八、下一步

安装完成后，你可以尝试创建一个简单的项目来熟悉 npm：

```bash
# 创建项目目录
mkdir my-first-project
cd my-first-project

# 初始化项目（会生成 package.json）
npm init -y

# 安装一个包试试
npm install lodash
```

恭喜你，Node.js 和 npm 已经准备就绪，可以开始你的开发之旅了！