Node.JS安装及环境配置完整步骤(万字详细版)

本章节我们将向大家介绍在 Windows上安装 Node.js 的方法。

Node.js 安装包及源码下载地址为：https://nodejs.org/en/download。

• Package Manager：
  • 使用系统自带的包管理工具（如 apt、yum、brew）安装。
  • 自动管理依赖和更新，适合命令行用户。
• Prebuilt Installer：
  • 官方提供的安装程序，适用于 Windows 和 macOS。
  • 图形化安装界面，包含 Node.js 和 npm。
• Prebuilt Binaries：
  • 预编译好的二进制文件，直接下载后解压即可使用。
  • 适合有技术背景、希望自定义安装位置的用户。
• Source Code：
  • Node.js 的源代码，需用户自行编译。
  • 提供最大灵活性，适合高级用户和需要自定义配置的开发者。

Node.js 官方针对不同系统已经给出了非常详细的安装命令，你可以根据不同平台系统选择你需要的 Node.js 安装命令脚本。

官方网站提供两个版本：

• **LTS（Long Term Support）：**长期支持版本，推荐用于生产环境
• **Current：**当前最新版本，包含最新特性

建议选择 LTS 版本，因为它更稳定且有长期技术支持。

Node.js 历史版本下载地址：https://nodejs.org/dist/

Windows 上安装 Node.js

你可以采用以下两种方式来安装。

1、Windows 安装包(.msi)

安装步骤：

1、双击下载后的安装包，如下所示：

2、点击以上的 Next 按钮，将出现如下界面：

3、勾选接受协议选项，点击 Next 按钮 :

4、Node.js默认安装目录为 “C:\Program Files\nodejs” , 你可以修改目录，并点击 Next 按钮：

5、点击 Install（安装） 开始安装 Node.js，你也可以点击 Back（返回）来修改先前的配置：

安装过程：

点击 Finish（完成）按钮退出安装向导。

安装完成后，我们可以在命令行或 Windows Powershell 中执行以下命令来测试：

node -v
npm -v

2、Windows 二进制文件 (.exe)安装

点击 “Prebuilt Binaries” 选项下载二进制文件：

安装步骤

步骤 1 : 双击下载的安装包 Node.exe ，将出现如下界面 :

点击 Run（运行）按钮将出现命令行窗口：

安装完成后，我们可以在命令行或 Windows Powershell 中执行以下命令来测试：

node -v
npm -v

如果你获得以上输出结果，说明你已经成功安装了Node.js。

使用命令行安装

我们也可以在 PowerShell 执行以下命令来安装：

# 安装 fnm（快速 Node 管理器）
winget install Schniz.fnm

# 配置 fnm 环境，使其在每次目录变更时自动使用
fnm env --use-on-cd | Out-String | Invoke-Expression

# 下载并安装 Node.js 版本 22
fnm use --install-if-missing 22

# 验证环境中 Node.js 的版本是否正确，输出应为 `v22.11.0`
node -v # 应该输出 `v22.11.0`

# 验证环境中 npm 的版本是否正确，输出应为 `10.9.0`
npm -v # 应该输出 `10.9.0`

Linux 上安装 Node.js

1、使用官方提供的安装脚本

本例以 fnm 安装包管理器位说明（也可以使用 nvm等），命令如下：

# 安装 fnm（快速 Node 管理器）
curl -fsSL https://fnm.vercel.app/install | bash

# 激活 fnm
source ~/.bashrc

# 下载并安装 Node.js
fnm use --install-if-missing 22

# 验证环境中的 Node.js 版本是否正确
node -v # 应该输出 `v22.11.0`

# 验证环境中的 npm 版本是否正确
npm -v # 应该输出 `10.9.0`

2、直接使用已编译好的包

点击 “Prebuilt Binaries” 选项下载二进制文件：

Node 官网已经把 linux 下载版本更改为已编译好的版本了，我们可以直接下载解压后使用：

# wget https://nodejs.org/dist/v22.11.0/node-v22.11.0-linux-arm64.tar.xz    // 下载
# tar xf  node-v22.11.0-linux-arm64.tar.xz       // 解压
# cd node-v22.11.0-linux-arm64/                  // 进入解压目录
# ./bin/node -v                                  // 执行node命令 查看版本

解压文件的 bin 目录底下包含了 node、npm 等命令，我们可以使用 ln 命令来设置软连接：

ln -s /usr/software/nodejs/bin/npm   /usr/local/bin/ 
ln -s /usr/software/nodejs/bin/node   /usr/local/bin/

3、源码安装 Node.js

以下部分我们将介绍在 Ubuntu Linux 下使用源码安装 Node.js 。 其他的 Linux 系统，如 Centos 等类似如下安装步骤。

在 Github 上获取 Node.js 源码：

$ sudo git clone https://github.com/nodejs/node.git
Cloning into 'node'...

修改目录权限：

$ sudo chmod -R 755 node

使用 ./configure 创建编译文件，并按照：

$ cd node
$ sudo ./configure
$ sudo make
$ sudo make install

查看 node 版本：

$ node --version
v0.10.25

Mac OS 上安装

1、使用官方提供的安装脚本

本例以 nvm 安装包管理器位说明（也可以使用 fnm 等），命令如下：

# 安装 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 下载并安装 Node.js（可能需要重启终端）
nvm install 22

# 验证环境中的 Node.js 版本是否正确
node -v # 应该输出 `v22.11.0`

# 验证环境中的 npm 版本是否正确
npm -v # 应该输出 `10.9.0`

2、使用预编译等安装工具

下载的 .pkg 文件，双击 .pkg 文件以启动安装向导。

3、直接使用已编译好的包

下载后，解压下载包，进入压缩包的 bin 目录，就可以看到已经编译好的 node 和 npm 了，可以直接在命令使用。

环境配置

（1）找到刚刚安装的目录，在安装目录下新建两个文件夹【node_global】和【node_cache】

（2）创建完毕后，复制刚刚创建的【node_global】和【node_cache】文件夹路径在cmd命令分别输入以下两条命令，注意不要两条命令的文件路径不要搞混了。

注：可以打开所创建的文件夹，把鼠标放在箭头指向的位置选择复制。

使用管理员身份打开cmd命令窗口（打开方法见下方Tips），输入以下命令（下面的路径是我创建的文件夹所在的路径，需要复制你们自己创建的路径哦）

①npm config set prefix “你的路径\node_global” （复制刚刚所创建的“node_global”文件夹路径）

npm config set prefix "D:\common\develop\Nodejs\node_global"

②npm config set cache “你的路径\node_cache” （复制刚刚所创建的“node_cache”文件夹路径）

npm config set cache “D:\common\develop\Nodejs\node_cache”

-----------可以输入以下两条命令查看路径是否配置正确------------

Tips: 使用管理员身份运行cmd的方法 ：点击左下角【开始】菜单，在搜索区域输入“命令提示符”，然后点击【以管理员身份运行】

=或单击鼠标右键选择【以管理员身份运行】============

（3）配置环境变量

①【此电脑】-单击右键-【属性】-【高级系统设置】-【环境变量】

② 在【系统变量】中点击【新建】

变量名：NODE_PATH

变量值：D:\common\develop\Nodejs\node_global\node_modules

随后在后续安装完express模块之后就会发现在【node_global】里自动多出了一个【node_modules】文件夹

③编辑【用户变量】中的【Path】

④将默认的 C 盘下【 AppData\Roaming\npm 】修改成 【node_global】的路径，点击【确定】

⑤在【系统变量】中选择【Path】点击【编辑】后点击新建【%NODE_PATH%】，随后一直点击【确定】直到关闭所有窗口即可。

四、测试

配置完成后，全局安装一个最常用的 express 模块进行测试（使用管理员方式打开cmd）

npm install express -g    // -g代表全局安装

出现以下界面即为配置成功

如果没有使用管理员方式打开cmd窗口的话，可能会报以下错误

解决方法①：

   在【C盘】下的【用户】找到  .npmmrc  文件，并将它删除（注意不是安装目录下的npm模块里的.npmmrc  文件，而是【C:\Users{用户}\下的.npmrc文件】）

删除之后在cmd窗口重新输入 npm install express -g ，则显示安装成功。

解决方法②：

   找到安装目录下的【node_global】和【node_cache】文件夹，鼠标右击【node_global】的文件夹，点击【属性】，再点击【安全】，再点击【编辑】，将权限都勾上，随即点击【确定】即可，【node_cache】步骤同理。

配置完成之后在cmd窗口重新输入 npm install express -g ，则显示安装成功。

五、安装淘宝镜像

淘宝镜像是淘宝团队为国内用户提供的npm镜像源，它与官方镜像源保持同步，并提供了更快的下载速度。

①安装淘宝镜像

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

查看是否成功：

 npm config get registry

②安装cnpm（按需安装）

说明： npm是node官方的包管理器。cnpm是个中国版的npm，是淘宝定制的 cnpm (gzip 压缩支持) 命令行工具代替默认的 npm。

npm install -g cnpm --registry=https://registry.npmmirror.com

查看是否安装成功

命令： cnpm -v

在查看版本号的时候，可能会出现【 ‘cnpm’ 不是内部或外部命令，也不是可运行的程序】的提示信息。

输入 npm config ls 查看配置信息，如果prefix和cache为以下路径则表示前面没有配置成功或者漏配了，需重新输入配置命令。

注：确认配置路径为自己创建的文件路径，修改结束之后先输入 npm uninstall cnpm -g 卸载原先安装的cnpm后再重新输入安装命令，最后查看版本号成功即安装成功。

附加：如果有出现问题的小伙伴们可以检查一下自己的配置有没有出错
①打开cmd敲以下命令检查

②打开环境变量配置检查

用户变量

系统变量

③打开安装目录检查是否有以下文件夹

····检查【node_global】里是否有【node_modules】文件夹

····上面所安装的cnpm、express会出现在【node_global】下的【node_modules】文件夹里

结尾

注：确认配置路径为自己创建的文件路径，修改结束之后先输入 npm uninstall cnpm -g 卸载原先安装的cnpm后再重新输入安装命令，最后查看版本号成功即安装成功。

附加：如果有出现问题的小伙伴们可以检查一下自己的配置有没有出错

①打开cmd敲以下命令检查

②打开环境变量配置检查

用户变量

系统变量

③打开安装目录检查是否有以下文件夹

····检查【node_global】里是否有【node_modules】文件夹

····上面所安装的cnpm、express会出现在【node_global】下的【node_modules】文件夹里

总结

到此这篇关于Node.JS安装及环境配置完的文章就介绍到这了,更多相关Node.JS安装及环境配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论