如何安装Node.js运行环境？-js教程-PHP中文网

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

如何安装node.js运行环境？

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
```
登录后复制
这样的版本号输出。

一览运营宝
一览“运营宝”是一款搭载AIGC的视频创作赋能及变现工具，由深耕视频行业18年的一览科技研发推出。

41

查看详情
验证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 <package>
```
  登录后复制
  ）可能会遇到权限问题。
- 解决方案： 不要轻易使用
  sudo npm install -g <package>
  登录后复制
  。虽然它能解决权限问题，但可能会导致更复杂的权限混乱。推荐的做法是改变npm全局安装目录的权限，或者更推荐的是使用NVM，NVM本身就解决了全局包的权限问题，因为它将包安装在用户目录下。如果你不使用NVM，可以参考npm官方文档配置npm的默认目录到用户可写的位置。
npm
登录后复制
命令正常，但
node
登录后复制
命令不正常，反之亦然：
- 问题： 这可能意味着Node.js和npm的路径在环境变量中没有同时被正确配置，或者它们来自不同的安装源。
- 解决方案： 重新检查环境变量，确保指向的是同一套Node.js安装目录。如果你使用了NVM，确保
```
nvm use <version>
```
  登录后复制
  已经执行，并且
```
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技术栈。

主流版本管理工具

NVM (Node Version Manager)
- 特点： 最流行、功能最完善的版本管理器，支持Linux和macOS。Windows用户可以使用非官方但功能类似的
```
nvm-windows
```
  登录后复制
  。它通过修改shell的环境变量来切换Node.js版本，非常灵活。
- 使用场景： 几乎所有需要管理Node.js版本的场景，尤其是在个人开发机上。
- 常用命令：
  - ```
  nvm install <version>
```
  登录后复制
  ：安装指定版本（例如
```
  nvm install 18
```
  登录后复制
  或
```
  nvm install --lts
```
  登录后复制
  ）。
- ```
nvm use <version>
```
    登录后复制
    ：切换到指定版本。
  - ```
  nvm ls
```
  登录后复制
  ：列出所有已安装的Node.js版本。
- ```
nvm alias default <version>
```
    登录后复制
    ：设置默认版本，每次打开新终端时自动使用。
  - ```
  nvm current
```
  登录后复制
  ：显示当前正在使用的Node.js版本。
- 我的看法： NVM是我的首选，它把版本管理变得异常简单。当你需要维护多个老项目，或者测试新特性时，NVM简直是救星。它几乎没有学习成本，而且功能强大，能让你在不同版本间无缝切换。
```
n
```
登录后复制
(Node.js version manager)
- 特点： 另一个Node.js版本管理工具，通常通过npm全局安装。它比NVM更轻量级，但功能也相对简单一些。它通过修改
```
/usr/local
```
  登录后复制
  下的符号链接来切换版本。
- 使用场景： 那些觉得NVM有点“重”的用户，或者只需要简单切换几个版本的场景。
- 常用命令：
  - ```
  npm install -g n
```
  登录后复制
  ：安装
```
  n
```
  登录后复制
  。
- ```
n lts
```
    登录后复制
    ：安装最新的LTS版本。
  - ```
  n latest
```
  登录后复制
  ：安装最新版。
- ```
n <version>
```
    登录后复制
    ：安装并切换到指定版本。
  - ```
  n
```
  登录后复制
  ：列出已安装版本并允许选择切换。
FNM (Fast Node Manager)
- 特点： 用Rust编写，以其速度快、性能高著称。它兼容
```
.nvmrc
```
  登录后复制
  和
```
.node-version
```
  登录后复制
  文件，可以自动切换项目所需的Node.js版本。
- 使用场景： 对性能有要求，或者追求更现代、更快速的工具的用户。
- 常用命令：
  - ```
  fnm install <version>
```
  登录后复制
- ```
fnm use <version>
```
    登录后复制
  - ```
  fnm default <version>
```
  登录后复制
- ```
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运行环境？的详细内容，更多请关注php中文网其它相关文章！