首页常见问题正文

Node.js安装步骤究竟是怎样的？

常见问题 2025-06-12 1134

如何安装Node.js：从入门到实践的完整指南

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它允许开发者使用 JavaScript 编写服务器端代码，从而构建高性能、可扩展的网络应用程序，无论是开发 RESTful API、实时聊天应用，还是构建命令行工具，Node.js 都是一个强大的选择，本文将详细介绍如何在不同操作系统（Windows、macOS 和 Linux）上安装 Node.js，并附带一些常见问题的解决方案,帮助你快速上手。

安装前的准备

在开始安装之前,你需要确认以下几点：

系统要求：Node.js 支持大多数现代操作系统，包括 Windows 7 及以上版本、macOS 10.10 及以上版本，以及主流的 Linux 发行版（如 Ubuntu、CentOS 等）。
网络连接：安装过程需要从官方网站下载安装包,因此确保你的设备已连接到互联网。
权限：在 macOS 和 Linux 上，安装某些软件可能需要管理员权限（如使用 sudo 命令）。

Windows 系统安装 Node.js

下载安装包

打开浏览器，访问 Node.js 官方网站。
在首页，你会看到两个版本：LTS（长期支持版） 和 Current（最新版）。
- LTS：适合生产环境,稳定性更高。
- Current：包含最新功能,适合开发测试。
点击适合你的版本（通常推荐 LTS），下载 .msi 安装包。

安装步骤

双击下载的 .msi 文件,启动安装向导。
在欢迎界面点击“Next”。
阅读许可协议，勾选“I accept the terms in the License Agreement”，然后点击“Next”。
选择安装路径（默认即可），点击“Next”。
在“Custom Setup”界面，你可以选择是否安装 npm（Node.js 的包管理工具）和其他组件，建议保持默认设置，点击“Next”。
点击“Install”开始安装。
安装完成后，点击“Finish”。

验证安装

打开命令提示符（Win + R，输入 cmd，回车）。
输入以下命令：
```
node -v
npm -v
```
如果显示版本号,说明安装成功。

macOS 系统安装 Node.js

使用 Homebrew 安装（推荐）

Homebrew 是 macOS 上的包管理工具，安装 Node.js 非常方便。

打开终端（Terminal）。

如果尚未安装 Homebrew，运行以下命令安装：

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

安装 Homebrew 后，运行以下命令安装 Node.js：
```
brew install node
```
验证安装：
```
node -v
npm -v
```

手动下载安装

访问 Node.js 官方网站，下载 .pkg 文件。
双击 .pkg 文件,按照提示完成安装。
验证安装：
```
node -v
npm -v
```

Linux 系统安装 Node.js

使用包管理器（以 Ubuntu 为例）

打开终端。
更新包索引：
```
sudo apt update
```
安装 Node.js 和 npm：
```
sudo apt install nodejs npm
```
验证安装：
```
node -v
npm -v
```

使用 NodeSource 仓库（推荐）

NodeSource 提供了更高效的 Node.js 安装方式。

添加 NodeSource 仓库：

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

（将 x 替换为你需要的版本）

安装 Node.js：
```
sudo apt install -y nodejs
```
验证安装：
```
node -v
npm -v
```

常见问题与解决方案

安装后版本不正确
- 可能是系统中有多个 Node.js 版本，建议使用 nvm（Node Version Manager）管理版本。
- 在 macOS 和 Linux 上，安装 nvm：
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
```
- 使用 nvm 安装 Node.js：
```
nvm install 18
nvm use 18
```
npm 权限问题
- 在 macOS 和 Linux 上，如果遇到权限错误，可以尝试以下命令：
```
sudo chown -R $USER:$(id -gn $USER) ~/.config
```
Windows 上 npm 安装全局包失败
- 修改 npm 的全局路径：
```
npm config set prefix "C:\Users\<YourUsername>\AppData\Roaming\npm"
```
- 将 C:\Users\<YourUsername>\AppData\Roaming\npm 添加到系统 PATH。