Skip to content

Node.js安装教程

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 键:
bash
winget install OpenJS.Nodejs.LTS
  • winget 会搜索 Node.js LTS 包,并询问你是否同意许可协议。输入 Yy 然后按 Enter 键继续。
  • winget 会自动下载并安装 Node.js 及其内置的 npm (Node Package Manager)。

步骤 4: 验证安装

  • 安装完成后,关闭当前的 PowerShell 或命令提示符窗口,然后重新打开一个新的窗口。这可以确保系统环境变量更新。

  • 在新的窗口中输入以下命令,然后按 Enter 键:

    bash
    node -v

    这会显示安装的 Node.js 版本号(例如:v18.17.1)。

  • 输入以下命令,然后按 Enter 键:

    bash
    npm -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 键:

    bash
    brew install node
  • Homebrew 会下载并安装 Node.js 的最新稳定版本以及内置的 npm (Node Package Manager)。

步骤 3: 验证安装

  • 安装完成后,关闭当前的终端窗口,然后重新打开一个新的窗口。这可以确保系统环境变量更新。

  • 在新的窗口中输入以下命令,然后按 Enter 键:

    bash
    node -v

    这会显示安装的 Node.js 版本号(例如:v20.5.0)。

  • 输入以下命令,然后按 Enter 键:

    bash
    npm -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