【Node.js】如何安装 Node.js

安装 Node.js 是一个简单且直接的过程，适用于 Windows、macOS 和 Linux 系统。以下是详细的安装步骤，涵盖多种安装方式、验证方法以及常见问题解决方法，确保你能顺利安装并开始使用 Node.js。

1. 准备工作

在安装 Node.js 之前，建议：

• 检查系统要求：Node.js 支持 Windows 10+、macOS 10.13+、大多数 Linux 发行版（如 Ubuntu、CentOS）。确保系统是 64 位，内存至少 4GB。
• 卸载旧版本（如有）：如果已安装旧版 Node.js，建议先卸载以避免冲突。
• 网络连接：安装过程需要联网下载安装包。

2. 安装 Node.js 的主要方法

Node.js 提供多种安装方式，根据你的需求和操作系统选择适合的方法。以下是详细步骤：

方法 1：通过官方网站下载安装（推荐初学者）

Node.js 官方网站提供预编译的安装包，适合大多数用户。

1. 访问官方网站：

   • 打开浏览器，前往 Node.js 官网。
   • 官网提供两个版本：
     • LTS（Long-Term Support）：稳定版，推荐用于生产环境（如 20.x.x）。
     • Current：最新版，包含新功能，适合尝鲜（如 22.x.x）。
     • 初学者建议选择 LTS 版本。

2. 下载安装包：

   • 根据你的操作系统（Windows、macOS 或 Linux）点击下载对应安装包。
   • Windows/macOS 用户会下载 .exe 或 .pkg 文件；Linux 用户可能需要 .tar.gz 文件。

3. 运行安装程序：

   • Windows：
     • 双击下载的 .exe 文件。
     • 按照向导点击“Next”，接受许可协议。
     • 选择安装路径（默认 C:\Program Files\nodejs），建议勾选“Add to PATH”以便全局使用。
     • 安装完成后，NPM（Node Package Manager）会自动安装。
   • macOS：
     • 双击下载的 .pkg 文件。
     • 按照向导完成安装，系统会自动配置环境变量。
   • Linux（以 Ubuntu 为例）：
     • 解压下载的 .tar.gz 文件：tar -xzf node-vXX.X.X-linux-x64.tar.gz。
     • 将解压后的文件夹移动到 /usr/local：sudo mv node-vXX.X.X-linux-x64 /usr/local/node。
     • 配置环境变量，编辑 ~/.bashrc 或 ~/.zshrc，添加：

       export PATH=/usr/local/node/bin:$PATH
       

     • 应用更改：source ~/.bashrc。

4. 验证安装：

   • 打开终端（Windows 使用 CMD 或 PowerShell，macOS/Linux 使用 Terminal）。
   • 输入以下命令检查 Node.js 和 NPM 版本：

     node -v
     npm -v
     

   • 示例输出：

     v20.17.0  # Node.js 版本
     10.8.3    # NPM 版本
     

   • 如果显示版本号，说明安装成功。

方法 2：使用包管理器（推荐 Linux 和 macOS 用户）

包管理器可以简化安装和版本管理，尤其适合 Linux 和 macOS 用户。

• macOS（使用 Homebrew）：

  1. 确保安装 Homebrew（若无，运行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）。
  2. 安装 Node.js：

     brew install node
     

  3. 验证：

     node -v
     npm -v
     

• Ubuntu/Debian：

  1. 添加 NodeSource 仓库以获取最新版本：

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

  2. 安装 Node.js 和 NPM：

     sudo apt-get install -y nodejs
     

  3. 验证：

     node -v
     npm -v
     

• CentOS/RHEL：

  1. 添加 NodeSource 仓库：

     curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
     

  2. 安装 Node.js：

     sudo yum install -y nodejs
     

  3. 验证：

     node -v
     npm -v
     

方法 3：使用版本管理器（推荐开发者）

版本管理器（如 nvm 或 fnm）允许在同一台机器上安装和切换多个 Node.js 版本，适合开发者或需要测试不同版本的用户。

• 使用 nvm（Node Version Manager）：

  1. 安装 nvm：
     • macOS/Linux：

       curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
       

     • Windows：使用 nvm-windows 并按照其安装说明操作。
  2. 加载 nvm：

     source ~/.bashrc  # 或 ~/.zshrc
     

  3. 安装指定版本的 Node.js：

     nvm install 20    # 安装 LTS 版本
     nvm install node  # 安装最新版本
     

  4. 切换版本：

     nvm use 20
     

  5. 验证：

     node -v
     npm -v
     

• 使用 fnm（Fast Node Manager）：

  1. 安装 fnm：

     curl -fsSL https://fnm.vercel.app/install | bash
     

  2. 安装 Node.js：

     fnm install 20
     

  3. 使用版本：

     fnm use 20
     

  4. 验证：

     node -v
     npm -v
     

3. 验证安装是否成功

安装完成后，运行以下命令确认 Node.js 和 NPM 正常工作：

node -v       # 显示 Node.js 版本
npm -v        # 显示 NPM 版本
node          # 进入 Node.js 交互式 REPL

• 在 REPL 中输入 console.log('Hello, Node.js!'); 并按回车，应输出 Hello, Node.js!。
• 退出 REPL：按 Ctrl+C 两次或输入 .exit。

此外，可以运行一个简单的 JavaScript 文件测试：

1. 创建文件 test.js：

   console.log('Node.js is working!');
   

2. 运行：

   node test.js
   

3. 应输出：Node.js is working!。

4. 常见问题及解决方法

• 问题 1：node -v 命令未找到：
  • 原因：Node.js 未添加到系统 PATH。
  • 解决：
    • Windows：重新运行安装程序，确保勾选“Add to PATH”。
    • macOS/Linux：检查环境变量，确认 export PATH=/usr/local/node/bin:$PATH 已添加到 ~/.bashrc 或 ~/.zshrc。
• 问题 2：NPM 安装包失败：
  • 原因：网络问题或权限不足。
  • 解决：
    • 使用国内镜像：npm config set registry https://registry.npmmirror.com。
    • Linux/macOS 使用 sudo npm install 或修复权限：sudo chown -R $USER ~/.npm。
• 问题 3：旧版本冲突：
  • 解决：卸载旧版本，删除残留文件夹（如 Windows 的 C:\Program Files\nodejs 或 Linux 的 /usr/local/bin/node），重新安装。
• 问题 4：安装缓慢：
  • 解决：使用包管理器或版本管理器，下载速度更快；或切换到国内镜像。

5. 安装后的推荐操作

• 更新 NPM（可选）：

  npm install -g npm
  

  确保使用最新版本的 NPM。
• 安装常用工具：
  • nodemon：开发时自动重启服务器。

    npm install -g nodemon
    

  • yarn（可选）：替代 NPM 的包管理器。

    npm install -g yarn
    

• 配置国内镜像（中国用户推荐）：

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

• 尝试第一个项目：
  创建一个简单的 HTTP 服务器（参考上一回答中的代码示例）或使用 Express 框架：

  npm init -y
  npm install express
  

6. 学习资源

• 官方文档：https://nodejs.org/en/docs/
• 教程：
  • FreeCodeCamp 的 Node.js 教程。
  • MDN Web Docs 的 Node.js 入门。
  • Bilibili 或 YouTube 上的 Node.js 教学视频。
• 社区：Stack Overflow、Node.js 官方 GitHub、Reddit。

7. 总结

安装 Node.js 推荐通过官方网站下载 LTS 版本（简单直接）或使用包管理器/版本管理器（灵活高效）。安装后，验证 Node.js 和 NPM 版本，确保环境配置正确。遇到问题时，检查 PATH、权限或网络设置。