Node.js安装教程详解与配置指南

亲爱的编程学习爱好者，如果你点开了这篇文章，说明你对《Node.js环境安装教程详解》很感兴趣。本篇文章就来给大家详细解析一下，主要介绍一下，希望所有认真读完的童鞋们，都有实质性的提高。

Node.js安装最推荐使用官方LTS版安装包或NVM版本管理器，确保环境变量配置正确后，通过node -v和npm -v验证安装，配合nvm可高效管理多版本切换，适用于不同项目兼容性需求。

Node.js的安装，其实比想象中要直接得多。核心流程无非就是从官方渠道获取安装包，或者借助系统自带的包管理器，然后简单地执行几步操作。关键在于，我们要确保Node.js和它自带的包管理工具npm（或者yarn，如果你更喜欢）能够被系统正确识别，也就是常说的“加入到环境变量中”。一旦这一步完成，你就可以在命令行里自由地启动Node应用，或者安装各种前端/后端库了。

解决方案

安装Node.js运行环境，根据你的操作系统和个人习惯，有几种主流方式。我个人更倾向于使用官方安装包或者版本管理器，它们能提供更好的控制和兼容性。

1. 适用于Windows和macOS用户的官方安装包方式（最直接且推荐）

这是最傻瓜、最省心的方法，尤其适合初学者。

• 访问官方网站： 打开你的浏览器，前往Node.js的官方网站 https://nodejs.org/。
• 选择版本： 你会看到两个主要选项：LTS（长期支持版）和Current（最新特性版）。我的建议是，除非你明确需要体验最新的实验性功能，否则请务必选择LTS版本。它稳定、经过充分测试，并且有更长的维护周期，能避免很多不必要的麻烦。
• 下载安装包： 根据你的操作系统（Windows通常是.msi文件，macOS是.pkg文件），点击下载对应的LTS安装包。
• 运行安装程序： 双击下载好的文件，启动安装向导。一路“Next”下去，通常保持默认设置就好。安装程序会自动帮你配置好Node.js运行时、npm包管理器以及将它们添加到系统的环境变量中。这一步，它会问你是否安装一些必要的工具，比如Python和Visual Studio Build Tools，如果你的开发工作涉及编译原生模块，建议勾选。
• 完成安装： 等待安装完成。

2. 适用于Linux用户的NVM（Node Version Manager）方式（推荐，尤其是有多版本需求时）

在Linux环境下，我极力推荐使用NVM。它不仅能安装Node.js，还能让你轻松地在不同Node.js版本之间切换，这对于维护多个项目或者测试兼容性来说简直是神器。

• 安装NVM： 打开你的终端，运行以下命令来安装NVM。这会从GitHub下载安装脚本并执行。

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

  或者使用wget：

  wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

• 激活NVM： 安装完成后，你需要让终端识别NVM。通常，你需要关闭并重新打开终端，或者手动执行以下命令来加载NVM到当前会话：

  source ~/.bashrc  # 如果你用的是Bash
  source ~/.zshrc   # 如果你用的是Zsh
  source ~/.profile # 或者这个，取决于你的shell配置

• 安装Node.js： 现在你可以用NVM来安装Node.js了。同样，我建议安装LTS版本。

  nvm install --lts  # 安装最新的LTS版本
  nvm use --lts      # 使用这个LTS版本

  如果你想安装特定版本，比如Node.js 18：

  nvm install 18
  nvm use 18

• 设置默认版本： 你可以设置一个默认的Node.js版本，这样每次打开新终端时都会自动使用它：

  nvm alias default <version> # 例如：nvm alias default 18

3. 通过Linux发行版包管理器（不推荐作为主要方式，可能版本较旧）

虽然这种方式也很简单，但通过系统自带的包管理器（如apt、yum、dnf等）安装的Node.js版本往往不是最新的LTS版，甚至可能停留在比较老的版本。如果你对Node.js版本有要求，最好避免这种方式。

• Ubuntu/Debian：

  sudo apt update
  sudo apt install nodejs npm

• CentOS/RHEL：

  sudo yum install nodejs npm

  或

  sudo dnf install nodejs npm

Node.js版本选择：LTS版本和最新版该如何抉择？

这几乎是每个Node.js开发者都会遇到的问题，特别是刚接触这个生态的新手。我的经验是，除非你有非常明确的理由，否则请坚定地选择LTS版本。LTS，全称是Long Term Support，顾名思义，它提供长期的支持和维护。这意味着它经过了更长时间的测试，稳定性极高，bug相对较少，并且有更长的生命周期，能让你在开发和部署时少操很多心。

而“最新版”（Current）则更像是Node.js团队在展示他们的最新成果，它包含了最新的语言特性、性能优化，甚至是实验性API。这些版本迭代速度快，可能引入一些不稳定的改动，或者存在一些尚未被广泛发现的bug。对于生产环境，追求这种“新”往往意味着承担更高的风险。想象一下，你的应用在某个新特性上跑得好好的，结果Node.js一升级，某个API改了，或者出现了一个难以追踪的bug，那真是欲哭无泪。

所以，我的个人建议是：

• 生产环境和大多数项目： 毫无疑问，LTS是你的首选。它能提供稳定可靠的运行环境，让你专注于业务逻辑，而不是疲于应对Node.js版本带来的兼容性问题。
• 学习新特性或尝鲜： 如果你只是想了解Node.js的最新发展，或者在非关键项目上尝试一些前沿功能，那么可以考虑安装最新版。但即便如此，我也建议你使用NVM这类工具，方便在不同版本间切换，避免污染主开发环境。
• 维护老项目： 这时候可能需要安装特定版本的Node.js，比如Node.js 12或14。NVM在这里就显得尤为重要，它能让你轻松地在不同项目之间切换，而不会影响到其他项目的运行。

总之，稳定压倒一切，尤其是在团队协作和项目长期维护的场景下。

Node.js安装成功了吗？验证方法与常见问题排查

安装完Node.js之后，最重要的一步就是验证它是否真的安装成功并且能正常工作。这就像你买了个新电器，总要插上电试试看能不能亮。

1. 基本验证

打开你的命令行工具（Windows用户是cmd或PowerShell，macOS/Linux用户是Terminal），输入以下两个命令：

• 验证Node.js版本：

  node -v

  如果安装成功，你会看到类似 v18.18.0 这样的版本号输出。

• 验证npm版本：

  npm -v

  同样，如果成功，你会看到类似 9.8.1 这样的npm版本号。

如果这两个命令都能正确输出版本号，那么恭喜你，Node.js和npm已经基本就绪了。

2. 运行一个简单的JavaScript文件

为了更进一步确认，我们可以写一个最简单的JavaScript文件来跑一下。

• 新建一个文件，命名为 hello.js，内容如下：

  console.log("Hello, Node.js! Installation seems good.");

• 在命令行中，进入到 hello.js 所在的目录，然后运行：

  node hello.js

  如果终端输出了 Hello, Node.js! Installation seems good.，那就说明Node.js运行时一切正常。

3. 尝试安装一个npm包

npm是Node.js生态系统的心脏，我们也要确保它能正常工作。

• 在一个空目录下，初始化一个npm项目：

  npm init -y

  这会创建一个 package.json 文件。

• 尝试安装一个常用的包，比如 lodash：

  npm install lodash

  如果一切顺利，你会看到 lodash 被下载并安装到当前目录的 node_modules 文件夹中，并且 package.json 也会更新。

常见问题排查

• 'node' is not recognized as an internal or external command 或 command not found: node：
  • 问题： 这是最常见的问题，意味着系统找不到 node 命令。通常是环境变量配置出了问题。
  • 解决方案：
    • Windows： 检查你的系统环境变量 Path。Node.js的安装目录（通常是 C:\Program Files\nodejs\）应该被添加到其中。如果没有，手动添加。添加后可能需要重启命令行窗口或电脑才能生效。
    • macOS/Linux： 如果你使用的是官方安装包，它通常会自动配置。如果是手动安装或NVM安装后出现问题，检查你的 ~/.bashrc, ~/.zshrc 或 ~/.profile 文件中是否有NVM相关的配置（如 export NVM_DIR="..." 和 [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"），并且确保这些文件在你的shell启动时被正确加载。
• npm ERR! code EACCES 或 Permission denied：
  • 问题： 在Linux/macOS上，尝试全局安装npm包时（npm install -g ）可能会遇到权限问题。
  • 解决方案： 不要轻易使用 sudo npm install -g 。虽然它能解决权限问题，但可能会导致更复杂的权限混乱。推荐的做法是改变npm全局安装目录的权限，或者更推荐的是使用NVM，NVM本身就解决了全局包的权限问题，因为它将包安装在用户目录下。如果你不使用NVM，可以参考npm官方文档配置npm的默认目录到用户可写的位置。
• npm 命令正常，但 node 命令不正常，反之亦然：
  • 问题： 这可能意味着Node.js和npm的路径在环境变量中没有同时被正确配置，或者它们来自不同的安装源。
  • 解决方案： 重新检查环境变量，确保指向的是同一套Node.js安装目录。如果你使用了NVM，确保 nvm use 已经执行，并且 nvm current 显示的是你期望的版本。

多版本Node.js管理：nvm、n、fnm工具对比与应用场景

在日常开发中，尤其是当你在多个项目之间切换时，你很快就会发现一个痛点：不同的项目可能依赖于不同版本的Node.js。比如，一个老旧的维护项目可能还在用Node.js 14，而你正在开发的新项目则要求使用Node.js 18或20。这时候，如果只有一个Node.js版本，你就得反复卸载安装，那简直是噩梦。幸运的是，Node.js社区为我们提供了优秀的版本管理工具，其中最流行且我个人最常用的是NVM (Node Version Manager)。

为什么需要多版本管理？

• 项目兼容性： 不同项目对Node.js版本有特定要求。
• 测试： 测试你的库或应用在不同Node.js版本下的兼容性。
• 新旧技术栈并存： 你的开发环境需要同时支持老旧和最新的Node.js技术栈。

主流版本管理工具

1. NVM (Node Version Manager)

   • 特点： 最流行、功能最完善的版本管理器，支持Linux和macOS。Windows用户可以使用非官方但功能类似的 nvm-windows。它通过修改shell的环境变量来切换Node.js版本，非常灵活。
   • 使用场景： 几乎所有需要管理Node.js版本的场景，尤其是在个人开发机上。
   • 常用命令：
     • nvm install ：安装指定版本（例如 nvm install 18 或 nvm install --lts）。
     • nvm use ：切换到指定版本。
     • nvm ls：列出所有已安装的Node.js版本。
     • nvm alias default ：设置默认版本，每次打开新终端时自动使用。
     • nvm current：显示当前正在使用的Node.js版本。
   • 我的看法： NVM是我的首选，它把版本管理变得异常简单。当你需要维护多个老项目，或者测试新特性时，NVM简直是救星。它几乎没有学习成本，而且功能强大，能让你在不同版本间无缝切换。

2. n (Node.js version manager)

   • 特点： 另一个Node.js版本管理工具，通常通过npm全局安装。它比NVM更轻量级，但功能也相对简单一些。它通过修改 /usr/local 下的符号链接来切换版本。
   • 使用场景： 那些觉得NVM有点“重”的用户，或者只需要简单切换几个版本的场景。
   • 常用命令：
     • npm install -g n：安装 n。
     • n lts：安装最新的LTS版本。
     • n latest：安装最新版。
     • n ：安装并切换到指定版本。
     • n：列出已安装版本并允许选择切换。

3. FNM (Fast Node Manager)

   • 特点： 用Rust编写，以其速度快、性能高著称。它兼容 .nvmrc 和 .node-version 文件，可以自动切换项目所需的Node.js版本。
   • 使用场景： 对性能有要求，或者追求更现代、更快速的工具的用户。
   • 常用命令：
     • fnm install
     • fnm use
     • fnm default
     • fnm ls
   • 我的看法： FNM是一个很有潜力的替代品，尤其是在大型项目中，其速度优势可能会体现出来。如果你对Rust生态有兴趣，或者想尝试更现代的工具，FNM值得一试。

何时需要多版本管理？

• 维护遗留项目： 当你接手一个老项目，它可能是在Node.js 14上开发的，并且在Node.js 18上会出现一些奇怪的兼容性问题。这时，你需要一个工具来快速切换回Node.js 14。
• 启动新项目： 你希望新项目能用上最新的Node.js特性，但又不想影响到其他依赖旧版本的项目。
• 库或框架开发者： 如果你开发一个Node.js库，需要确保它能在多个Node.js版本上正常运行，以便覆盖更广泛的用户群体。
• 学习和实验： 尝试Node.js的最新版本，看看有什么新功能，而不用担心会破坏你现有的开发环境。

总的来说，版本管理工具是Node.js开发者工具箱中不可或缺的一部分。选择一个适合你的工具，可以极大地提升开发效率和体验。我个人觉得，对于大多数开发者来说，NVM是那个“万金油”式的存在，用起来省心又高效。

好了，本文到此结束，带大家了解了《Node.js安装教程详解与配置指南》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！