Node.js 是一个开源的 JavaScript 运行环境,它允许你在服务器端运行 JavaScript 代码。很多现代前端开发工具(包括 React)都依赖于 Node.js,所以安装它非常重要。
Windows 用户 (使用 winget)
winget 是 Windows 10 (1709 及更高版本) 和 Windows 11 内置的包管理器。它让安装应用变得非常简单。
步骤 1: 确认你的 Windows 版本和 winget
- winget 需要 Windows 10 1709 (Build 16299) 或更高版本。你可以通过在搜索栏输入 "winver" 并按 Enter 键来查看你的 Windows 版本。
- winget 通常是预装的。你可以在 PowerShell 或命令提示符中输入
winget
并按 Enter 键来确认它是否存在。如果显示 winget 的帮助信息,则说明它已安装并可用。 - 如果你的 Windows 版本太旧或者 winget 不可用,你可能需要通过 Microsoft Store 安装 "应用安装程序" 来获取最新的 winget。
步骤 2: 打开 PowerShell 或命令提示符
- 在 Windows 搜索栏输入 "PowerShell" 或 "命令提示符"。
- 点击打开应用程序。
步骤 3: 使用 winget 安装 Node.js
- 我们将安装 Node.js 的 LTS (长期支持) 版本,这是推荐的稳定版本。
- 在 PowerShell 或命令提示符中输入以下命令,然后按 Enter 键:
winget install OpenJS.Nodejs.LTS
- winget 会搜索 Node.js LTS 包,并询问你是否同意许可协议。输入
Y
或y
然后按 Enter 键继续。 - winget 会自动下载并安装 Node.js 及其内置的 npm (Node Package Manager)。
步骤 4: 验证安装
安装完成后,关闭当前的 PowerShell 或命令提示符窗口,然后重新打开一个新的窗口。这可以确保系统环境变量更新。
在新的窗口中输入以下命令,然后按 Enter 键:
bashnode -v
这会显示安装的 Node.js 版本号(例如:
v18.17.1
)。输入以下命令,然后按 Enter 键:
bashnpm -v
这会显示安装的 npm 版本号(例如:
9.6.7
)。
如果两个命令都能正确显示版本号,恭喜你,Node.js 和 npm 已成功安装在你的 Windows 系统上!
macOS 用户 (使用 Homebrew)
Homebrew 是 macOS 上非常流行的包管理器,它让安装开发工具变得非常简单。
步骤 1: 安装 Homebrew (如果尚未安装)
如果你已经安装了 Homebrew,可以直接跳到步骤 2。
打开你的终端应用程序 (可以在 Spotlight 搜索中输入 "Terminal")。
复制并粘贴以下命令到终端中,然后按 Enter 键:
bash/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Homebrew 会提示你安装一些依赖(例如 Command Line Tools for Xcode),并询问你输入你的用户密码。按照终端中的指示进行操作。
安装过程可能需要一些时间。完成后,终端会提示你 Homebrew 已安装成功。
步骤 2: 使用 Homebrew 安装 Node.js
在终端中输入以下命令,然后按 Enter 键:
bashbrew install node
Homebrew 会下载并安装 Node.js 的最新稳定版本以及内置的 npm (Node Package Manager)。
步骤 3: 验证安装
安装完成后,关闭当前的终端窗口,然后重新打开一个新的窗口。这可以确保系统环境变量更新。
在新的窗口中输入以下命令,然后按 Enter 键:
bashnode -v
这会显示安装的 Node.js 版本号(例如:
v20.5.0
)。输入以下命令,然后按 Enter 键:
bashnpm -v
这会显示安装的 npm 版本号(例如:
9.8.0
)。
如果两个命令都能正确显示版本号,恭喜你,Node.js 和 npm 已成功安装在你的 macOS 系统上!
故障排除提示
- 网络问题: 如果下载过程中遇到网络问题,可以尝试切换网络环境或使用镜像源。
- 权限问题: 在 macOS 上,如果遇到权限问题,尝试在命令前加上
sudo
(例如:sudo brew install node
),但这通常不推荐用于 Homebrew 安装。先检查你的用户是否具有安装软件的权限。 - 更新包管理器: 在安装 Node.js 之前,可以先更新你的包管理器:
- Windows (winget):
winget upgrade --all
- macOS (Homebrew):
brew update
- Windows (winget):