配置指南-掌握Node.js配置

导言

本文通过简要介绍 npm、nvm 和 node 的关系以及它们对于开发者的重要作用，帮助读者理解和配置这些工具

在我的日常开发过程中，使用到很多前端开发工具、构建工具（如 vite-cli）、打包工具（如 webpack），这些工具通常需要通过 npm 进行安装

我还使用到许多的后端前沿框架、容器（如 Docker）和各类数据库驱动服务（如 MongoDB），这些框架通常使用 npm 进行安装和管理

总的来说，Node.js 环境在前端开发、后端开发、构建工具、自动化测试、静态代码分析等方面都有广泛的应用。它为开发者提供了大量的工具和框架，使得开发更加高效和便利

总的来说，Node.js 环境是非常重要的，我们当然不会将以上涉及到的庞大的知识体系逐一讲解，我们将要学习的，是 Node.js 的基础配置，为我们以后的开发打下坚实的基础

正文

Nodejs 安装

2024 年 6 月 3 日

linux 安装 nodejs yum

在 Linux 系统中，您可以使用 Yum 包管理器来安装 Node.js。以下是一个基本的步骤和示例代码，用于通过 Yum 安装 Node.js：

1. 首先，您需要确保您的系统中已经安装了 Node.js 的官方 Yum 仓库。如果尚未安装，您可以通过运行以下命令来添加 Node.js 的仓库：

curl -sL https://rpm.nodesource.com/setup_14.x | sudo bash -

这个命令会将 Node.js 14.x 的仓库添加到您的系统中。如果您想安装其他版本的 Node.js，只需将setup_14.x中的数字更改为所需的 Node.js 版本即可。

1. 接下来，您可以使用 Yum 安装 Node.js：

sudo yum install -y nodejs

这个命令会从刚才添加的 Node.js 仓库中安装 Node.js。

1. 安装完成后，您可以检查 Node.js 的版本确保安装成功：

node --version

请注意，上述命令中的 URL 和版本号可能会随着 Node.js 版本更新而变化，请参照 Node.js 官方文档或者 NodeSource 提供的最新安装脚本。

概念

什么是 Node.js：

Node.js是一个基于Chrome V8引擎的JavaScript运行环境。它允许开发者使用JavaScript来构建服务器端的高性能应用程序。它提供了一种非阻塞、事件驱动的编程模型，使得处理并发、I/O密集型的任务变得更加高效和可扩展。通过Node.js，开发者可以使用熟悉的JavaScript语言来构建快速、可靠的服务器端应用程序

• 我们还可以从其他相关资料中，了解到 Node.js 环境是什么样的，是用来干什么的

• Node.js：Node 基础_51CTO 博客_node.js 是什么

• 一篇文章搞定什么是 nodeJs 它和 NPM 关系与应用 - 掘金 (juejin.cn)

什么是 npm：

npm是Node Package Manager的缩写，是一个用于Node.js项目的包管理工具。它是世界上最大的包管理器，拥有数量庞大的开放源码软件包和模块供开发者使用。通过npm，开发者可以方便地安装、更新和管理项目所需的依赖包，以及运行和测试脚本。

什么是 nvm：

nvm是Node Version Manager的缩写，它是一个工具，允许你在同一台机器上安装和管理多个Node.js版本。nvm使得开发者可以轻松切换不同的Node.js版本，而无需手动安装和配置每个版本。这对于开发者来说非常有用，因为不同的项目可能需要不同的Node.js版本，nvm可以帮助开发者更好地管理这些版本。

nvm、npm 和 Node.js 的关系：

nvm是Node Version Manager的缩写，它是一个工具，允许你在同一台机器上安装和管理多个Node.js版本。这对于开发者来说非常重要，因为不同的项目可能需要不同的Node.js版本，nvm允许你在这些项目之间轻松切换，而无需手动安装和配置每个版本

Node.js则是这两个工具的基础，它提供了一个JavaScript运行环境，使得开发者可以在服务器端构建高性能的应用程序。npm和nvm作为与Node.js紧密相关的工具，为开发者提供了更好的开发和管理环境。

• 这上面说的真他妈官方，总结起来就一句话：

• Node.js 是一种开发环境，npm 是一种包管理工具，管理 Node.js 项目所需依赖包；nvm 是一种版本管理工具，可以管理多个不同的 Node.js 版本，这就是三者的联系

Node.js 的配置

• 有关 Node.js 的安装配置有两种，我们可以单独下载并配置，这样做的好处是快捷方便，但是将来要更换其版本就会较为繁琐

• 另一种方法是使用 nvm 统一管理，更加轻松方便切换不同的 Node.js 版本，推荐使用这种方法

• 接下来相关下载安装配置均在 windows 系统上执行，因为本人在 Linux 系统上使用 Node.js 环境较少，有机会可以学习下

单独配置

• 官网下载 node.js：https://nodejs.org/zh-cn/download/

• 本地解压安装，查看 node 目录结构：

• 配置环境变量

• 注意，这里要配置两个环境变量：node 的根目录、根目录下的 node_global 路径

---

• 配置的时候细心点就行了，大功告成

使用 nvm 统一管理（推荐）

• 其实就是比单独配置多了两步：官网下载 nvm、配置 nvm 根目录环境变量

• 官网下载 nvm： https://github.com/coreybutler/nvm-windows/releases

• 本地解压安装，查看 nvm 目录结构：

• 配置环境变量

---

• 下载安装、配置环境变量还是非常简单的

目录介绍

• 刚才我们讲到如何配置环境变量，那么我们为什么要这样配置环境变量？Node.js 下的目录结构又是怎样的呢？

• 解决了这些问题，就能更好地理解 Node.js 的作用，拓展相关解决问题的思路

• 接下来我们就来了解下目录下个文件的作用

• Node.js 学习：基本目录结构 - 灰信网（软件开发博客聚合） (freesion.com)

• 日后补充。。。

常用命令

• 使用 nvm 来管理多个不同版本 node.js 还是很爽的，那我们了解一下常见的 nvm 相关命令吧

• nvm 常用命令：nvm 常用命令 切换 node 版本 - 简书 (jianshu.com)

• 我经常使用的就这几个：

node -v    					   #查看node版本

npm -v     				       #查看npm版本

nvm -v	                       #查看nvm版本

nvm list					   #查看已安装的node版本号

nvm list available			   #查看可安装的node版本

nvm install 【版本号】			#安装指定版本的node

nvm use 【版本号】				#使用指定版本的node

nvm uninstall 【版本号】			#卸载指定版本的node

npm config get registry			   #查看当前下载源

npm config set registry http://registry,npm.taobao.org            #设置下载源为淘宝源

npm config get prefix          #获取npm全局安装地址

npm config get cache           #获取npm全局缓存位置

npm config set prefix "D:\softWare\nvm\nvm\v16.19.0\node_global"   #修改npm全局安装位置

npm config set cache "D:\softWare\nvm\nvm\v16.19.0\node_cache"     #修改npm全局缓存位置

yarn config get registry			   #查看当前下载源

yarn config set registry https://registry.yarnpkg.com	#淘宝源

yarn config set registry https://registry.npmmirror.com		#源

-

• 查看 node、npm、nvm 版本

• 这也是检验 node、npm、nvm 是否配置成功的方法

• 查看已安装的 node 版本号

• 查看可安装的 node 版本，并安装最新版

• 使用指定版本的 node

实践

Linux 安装 Node.js

2024 年 5 月 8 日

可以参考这个博客

Linux 系统下 Node.js 的安装步骤_linux 安装 node.js-CSDN 博客

方法一：源码安装

在这个网站下找到需要安装的 Node.js 版本：Index of /dist/ (nodejs.org)

像这样，找到 18.16.1 版本的，直接点进去：

右键选择复制链接，复制好的链接是这样的：

https://nodejs.org/dist/v18.16.1/node-v18.16.1-linux-x64.tar.gz

打开终端，输入 wget 下载命令，下载刚找到的 Node.js 包：

wget https://nodejs.org/dist/v18.16.1/node-v18.16.1-linux-x64.tar.gz

呐，等待下载完成即可。

解压下载完成的压缩包：

tar -xzvf node-v18.16.1-linux-x64.tar.gz

方法二：一键安装

直接在终端执行以下命令，等待安装即可，速度很快的

sudo yum install nodejs

查看下 nodejs 版本，可以看到已经安装成功了：

node -v

如何选择安装指定版本呢？需要了解到：

yum（Yellowdog Updater Modified）是 Red Hat、CentOS 和其他基于 RPM 的 Linux 发行版上的包管理器，它通常不提供直接安装特定软件版本的功能。yum 通常只管理其软件仓库中提供的软件包，这些仓库中的软件包可能不是最新的，或者只包含有限版本的集合。

要安装特定版本的 Node.js，你可以使用以下方法之一

方法三：通过 NVM 安装

NVM 是一个允许你安装和管理多个 Node.js 版本的工具。首先，你需要安装 NVM，然后使用 NVM 来安装和切换不同版本的 Node.js。

安装 NVM 的典型命令是：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# 或者
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

安装完 NVM 后，你可以使用以下命令来安装特定版本的 Node.js：

nvm install 14.17.0  # 安装 Node.js 14.17.0 版本
nvm use 14.17.0       # 使用 Node.js 14.17.0 版本

请注意，你需要将版本号（如 14.17.0）替换为你想要安装的 Node.js 版本。

Linux 安装 Git

直接一键安装：

yum install git

linux ubuntu 的 su: Authentication failure 问题 & sudo passwd 输入密码时,总是提示 sorry,try again 问题（笔记）_sudo 输入密码显示对不起请重试-CSDN 博客

踩坑经历

settings.txt 文件错误

• 我在重新配置环境变量以后，再次执行 nvm -v 命令，发现了这个错误：

ERROR open \settings.txt: The system cannot find the file specified

• 出错原因及解决办法：(67 条消息) nvm 报错： ERROR open \settings.txt: The system cannot find the file specified_CamphorBloom 的博客-CSDN 博客

• 就是找到 nvm 根目录下的 settings.txt 文件，修改其中内容如下图所示：

• 

---

• 其实还是上面提到的：重新配置 nvm 及 node 环境变量以后，记着同步这个 settings.txt 文件

修改 node 版本无效

• 当你的 nvm 管理多个不同版本的 node 时，如果版本切换之后无效，则可能的原因是由于之前配置环境变量时，把 node 的路径写死了。重新配置环境变量的路径后即可切换版本生效

node 版本过高/过低

• 没错，node 版本过高/过低都会引发问题，不过这里并不是特指一个问题，而是各种程序运行时，所需 node 环境不同

• 我这里举两个我遇到的案例：

在本地启动VuePress文档站点服务时，由于node版本过高，启动失败
我将node版本从18.16.1修改至16.19.0后，成功解决问题

在安装配置VitePress文档站点的hope主题时，由于node版本过低，安装失败
我将node版本从16.19.0修改至18.16.1后，成功解决问题

• 这里也能比较出 VuePress 站点生成器相较于 VitePress，是有点落后了

• 有关详细案例还请移步至文章：《大道至简：快速搭建博客与文档站点的终极指南 1.0》

• 这里其实涉及到一个兼容性问题，不同的程序需要的或者说兼容的 node 环境是不一样的，

• 以我的经验来看，看情况按需修改 node 版本以适应不同需求即可，没有特别好的办法

• 当 node 版本过高时，可能会遇到难以预料的错误（这一点我深有体会）。即使你下载的是 LTS（长期支持版），但高版本的 node 总会出现莫名的问题，此时必须切换至低版本的 node，即可能出现如下报错：

node:internal/crypto/hash:71 this[kHandle] = new _Hash(algorithm, xofLen)；

• 高版本 node 报错解决方法：解决方法_胡八一 的博客-CSDN 博客

淘宝镜像出问题

• 最近使用 npm install 时，出现以下报错：（2023/08/01 早）

[##################] \ reify:typescript: timing reifyNode:node_modules/@babel/parser Completed in 291ms

• 这是因为 npm 默认的镜像设置为了淘宝镜像，这镜像老出毛病，修改 npm 镜像为官方镜像即可：

npm set registry https://registry.npmjs.org/

• (87 条消息) npm install 卡在了 reify:rxjs: timing reifyNode，出现 gyp ERR find Python、gyp ERR find VSreify:rxjs 卡了然后报错坐等夕阳落 time 的博客-CSDN 博客

yarn 安装失败

• 最近在开发 PicMemories 壁纸分享小程序，想着给开发一个后台管理员页面，正好借用下 API 接口开放平台的 Ant Design Pro 框架

• 结果在使用 umi/router 进行页面跳转时，安装依赖老是失败

• 我跟着官网操作，一直报错，执行以下命令也不显示 umi 版本：（2023/08/08 晚）

umi -v

• 官网：在页面间跳转 | UmiJS

• 然后我就看到报错信息，问了一下 AI，那大聪明教我添加环境变量，让 yarn 生效即可（？！）

• 我还真照做了：

• 结果当然是后来的各种命令都是在执行过程中，各种报错，如：

yarn install

yarn start:dev			#启动项目

• 把那个环境变量删除了，又出现了这么个错误：

info There appears to be trouble with your network connection. Retrying...

• 这个是真恶心，我改了镜像源还是无效：

yarn config get registry			   #查看当前下载源

yarn config set registry https://registry.yarnpkg.com	#淘宝源

yarn config set registry https://registry.npmmirror.com		#源

• 前端 npm, yarn, pnpm 下载速度太慢，设置国内镜像源的几种方式，让其速度飞起来pnpm 镜像一枚码农 404 的博客-CSDN 博客

• 两天后，终于找到了解决办法：（2023/08/08 晚）

• 直接放原文了，以后再整理吧：

• info There appears to be trouble with your network connection. Retrying…_泡椒猪肝的博客-CSDN 博客

• 总之，这样执行完命令之后，我重新执行了以下命令，发现成功了：

yarn install

• 然后我又在新拉取下来 API 项目下执行了该命令，结果报错了：

• 看报错信息，把 config/config.ts 下的 requestRecord 删除就行了，也不知道抽什么风了

openAPI: [
   {
     requestLibPath: "import { request } from '@umijs/max'",
     schemaPath: 'http://localhost:8101/api//v2/api-docs',
     projectName: 'memory-api',
   },
 ],
 mfsu: {
   strategy: 'normal',
 },
 requestRecord: {},

• 问题完美解决，项目成功启动了

其他问题

• 还要注意的是，修改环境变量配置后，有时候在短时间内是不会生效的，这个坑我踩过好多遍了，我的经验是要等待 3 - 5 分钟才会生效的

• 还有就是你平时见到的像如下所示的报错，九成的概率是环境变量配置错误了，赶紧检查一下环境变量吧

nvm/npm/node/hexo不是内部或外部命令

VuePress 搭建 Blog 启动失败

• 最初还以为是 node.js 版本问题，结果是 modules 目录构建有问题（2023/11/25 晚）

• 解决了，方案如下：
• 删除目录下的 modules 目录，执行以下命令重新构建 modules 目录：

yarn install

• 再次尝试启动 blog，启动成功：

经验总结

pnpm 全局安装无效

• 在配置 vuepress 文档站点的主题时，需要用到 pnpm 包管理器来安装执行命令，于是想了解 npm、pnpm、yarn 的区别和安装方法

• 关于这块的详细内容，可以在《理解 npm、pnpm 和 yarn：选出最适合你的包管理器》一文中了解

• 这里我介绍下我遇到的 pnpm 全局安装后，pnpm 命令仍不生效的问题

• 我在使用如下命令进行全局安装 pnpm 包管理器后，仍然报错：‘pnpm‘ 不是内部或外部命令，也不是可运行的程序或批处理文件

npm i -g pnpm

• 这其实是因为在我们配置了 nvm 后，没有修改 npm 全局安装地址，导致 pnpm 没有安装在 nvm 管理下的 Node.js 目录下

• 这样就导致了我们在 nvm 管理下，配置的 Node.js 环境变量未对 pnpm 生效

• 这里涉及到 Node.js 环境变量的配置相关知识，详情可在上文 Node.js 的配置一栏中了解

• 如上图所示，npm 默认状态下，pnpm 全局安装在了 D:\softWare\node\node_global 下，导致在 nvm 管理下，配置的 Node.js 环境变量未对 pnpm 生效

• 解决方法很简单，修改 npm 默认全局安装地址，将 pnpm 安装在已配置好的 Node.js 环境变量目录下即可

• 执行以下命令，修改 npm 默认全局安装地址为在 nvm 管理下的 Node.js 目录下的 node_global 下

npm config set prefix "D:\softWare\nvm\nvm\v16.19.0\node_global"

• 在此执行全局安装 pnpm，可以看到 pnpm 已成功安装在 nvm 管理下的 Node.js 目录下的 node_global 下了

• 执行以下命令，查看 pnpm 版本，结果如图所示：

pnpm -v

• 显然，pnpm 全局安装完成，可以正常使用

• 当然，有关 pnpm 常用命令和使用规范，可在《理解 npm、pnpm 和 yarn：选出最适合你的包管理器》一文中详细了解到

• 有关设置 npm 默认全局安装地址的详情，可看这篇博客：

• (71 条消息) 查找 npm 默认全局安装地址、缓存位置及设置安装地址、缓存位置npm 缓存位置俺是老王的博客-CSDN 博客

• 查找 npm 默认全局安装地址、缓存位置及设置安装地址、缓存位置

修改 node 版本

• 使用 nvm 管理不同版本的 node 后，修改 npm 版本时要注意以下几点：

  1. 修改可能会失效，这是因为环境变量写死了上个一个 node 版本了，修改 NODE_PATH 路径即可

  2. npm 全局安装路径也要注意同步修改，改成新版本下的 node_global 目录下

  3. 检查原 node 环境下的构建工具、包管理工具是否成功安装

• 第二个错误我就犯过，没有及时修改全局安装路径，导致安装 pnpm 后，pnpm 又失效了

• 第三个要特别注意，新的 node 环境下可能没有原 node 环境下的构建/包管理工具，当你在新 node 环境下使用这些工具时，会报如下错误：

***既不是外部命令，也不是可执行的内部命令

• 很常见的问题，确认 Node.js 环境变量配置无误后，执行 npm 全局安装该工具即可：

npm i -g ***

• 这就是修改 node 版本时，需要注意的要点及如何解决可能出现的相关问题

Linux 一键安装 Node.js 环境

• 在 Linux 系统中，可以使用以下命令安装最新版本的 Node.js：（2023/11/26 午）

curl -sL https://deb.nodesource.com/setup_current_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

• 在 macOS 系统中，可以使用 Homebrew 安装最新版本的 Node.js：

bash复制代码
brew install node@latest

• Linux 安装 nodejs 命令方法_linux 安装 node18_xaiolele 的博客-CSDN 博客

总结

• Node.js 的配置还是比较容易的，有机会的话，后续会持续更新进阶的 Node.js 的配置教学

• 非常感谢您能够阅读到这里，感谢您对本人的支持！