Node.js 环境搭建:安装、nvm 与 LTS

安装 Node.js、切换项目版本,并确认终端使用的运行环境。

🎯 引言

学完这篇文章,你能安装 Node.js、切换项目版本,并确认终端使用的运行环境。


🧱 选择受支持的版本

LTS 表示长期支持版本,会在支持期内持续得到相应维护,适合学习和需要稳定运行的项目。Current 是当前新功能版本,EOL 表示已结束维护。选择时查看官方版本状态,不要只比较版本数字大小。

本课程固定使用 Node.js 24.19.0 复现示例。实际项目应在兼容性验证后跟进受支持分支的安全更新,不应因为教程固定了版本而长期停止更新。


🛠 安装与检查

只需要一个版本时,可以从 Node.js 下载页选择自己的操作系统。Windows 可使用 .msi 安装程序,macOS 可使用 .pkg 安装程序,打开后按步骤安装;Linux 或需要多个版本时,可以采用下文的 nvm 方式。安装完成后重新打开终端。

先执行 node -v,安装课程版本时会输出 v24.19.0,表示终端能够找到并运行 Node.js。若提示找不到命令,先重新打开终端,再检查是否完成安装。

再执行 npm -v,它会输出 npm 的版本,例如 11.11.0;以实际安装结果为准。npm 是包管理器,用于安装项目需要的第三方代码,它与 Node.js 是不同工具,因此版本号不需要相同。

Node.js 下载页及安装程序会更新,按钮名称和入口位置可能变化。以上流程仅供参考,操作时以当前官方页面为准。

🧰 用 nvm 管理多个版本

nvm 是 Node.js 版本管理工具,让不同项目使用不同版本,避免来回卸载。macOS、Linux 和 Windows 的 WSL 环境可按 nvm 官方安装说明安装;WSL 是 Windows 中运行 Linux 环境的方式。

Windows 原生终端可使用 nvm-windows,它是另一个项目,安装和配置方式应按它自己的文档操作,不能直接照搬 nvm 的安装脚本。

这些项目的安装说明和安装界面会更新,以下命令以 macOS/Linux 的 nvm 为例;请先完成对应平台的安装,再执行命令。

macOS/Linux:安装版本管理工具

以下采用 nvm 0.40.3。按其官方安装说明,在终端执行:

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

curl 下载指定版本的安装脚本,管道后的 bash 执行它,将 nvm 安装到当前用户环境并配置终端加载方式。执行完成后关闭并重新打开终端,运行 nvm --version,能看到 0.40.3 就表示工具可用了。

如果提示找不到 nvm,根据安装输出检查当前终端的配置文件是否加载了 nvm,再重新打开终端;此时先不要继续执行 Node.js 的版本切换命令。

安装并选用 Node.js 版本

先下载课程使用的版本:

nvm install 24.19.0

安装成功后,工具会提示可以使用对应版本。这个操作把版本装到本机,不要求删除其他项目正在使用的版本。

在需要使用它的终端中执行切换:

nvm use 24.19.0

成功时会提示正在使用 v24.19.0。接着执行 node -v,确认实际结果为 v24.19.0;以后进入另一个终端时仍需检查当前版本。

用 .nvmrc 记录项目约定

macOS/Linux 的 nvm 项目可在根目录创建 .nvmrc,内容只有一行 24.19.0。以后进入项目执行 nvm use,不写版本号,nvm 就会读取这个文件并切换到相应版本。

如果该版本还没安装,先在这个目录执行 nvm install。.nvmrc 是版本记录文件,不会单靠文件存在就自动切换终端环境。

如果切换后版本不对,先重新打开终端,再用 macOS/Linux 的 command -v node 或 Windows 的 where.exe node 查看命令来自哪里。机器上多个安装来源可能导致命令指向另一个版本。


❓ 知识问答

Q1:安装了 Node.js 还要单独安装 npm 吗?

常见官方安装方式会一起提供 npm,先运行 npm -v 检查。

Q2:同事能只靠 .nvmrc 自动切换吗?

需要安装兼容的版本管理工具,并执行切换命令或配置自动切换。

Q3:所有系统都用同一个 nvm 吗?

不是,nvm-windows 与 nvm-sh/nvm 是不同工具。


🧪 小练习

切换到课程版本,创建 version.mjs,使用 console.log(process.version) 输出版本,与 node -v 的结果对比。process.version 表示实际执行当前文件的 Node.js 版本。

// 请在这里编写代码

🎉 现在可以用自己的例子验证这些用法啦!