nvm安装和使用指南 | 默默的博客

type

Post

status

Published

date

Nov 28, 2024

slug

nvm

summary

nvm踩坑笔记

1、安装nvm：

安装nvm要卸载原先的node环境，并且删除原先的npm全局环境设置（因为node环境卸载之后，NODE_PATH不会自动删除），nvm安装node之后(应该)会自动创建新的NODE_PATH。

如果不卸载原先的node环境，安装nvm后，会提示导入旧的node环境，一定要手动修改原先的全局环境设置（因为旧的node环境导入之后，NODE_PATH并不会自动修改）。

如果NODE_PATH和你的nvm的全局环境设置不一致，nvm切换node版本时可能无法切换npm为对应版本，只能手动切换。

删除或修改环境变量：

高级系统设置→环境变量→（用户变量和系统变量都检查一下）→NODE_PATH（一般值里面有node_global文件夹），修改为与nvm的全局环境路径一致。

安装nvm时，第一个路径是nvm安装路径，第二个symLink是软连接路径(用来指向当前使用的版本的node文件夹)——如果你是更新nvm，且更新时选择同一symLink路径时报错该路径不为空，可以先删除之前的软连接文件夹(注意别把对应的node文件夹删掉了，如果删掉了可以在安装完成之后从回收站复原)

2、安装node版本

nvm可以通过命令nvm list available来查看部分常用的node版本号，然后通过nvm install <版本号>来下载对应的node版本。

如果下载安装时报错，哪怕没装上也要输入命令nvm ls检查当前存在的node版本(nvm管理的node版本)，如果存在安装失败的版本，需要使用命令nvm uninstall <版本号>删除一次对应版本的node环境，再重新安装。

3、安装nvm无法下载的node版本

nvm的工作原理是通过软连接，将自身的全局环境node_global文件夹指向不同版本的node的文件夹，来达到切换node版本的功能。(应该是这样的，软连接和硬链接有兴趣可以自己了解一下)

所以如果实在装不上，就下载对应的node版本的zip压缩包导入吧（解压到nvm的文件夹），安装和卸载，其实就是在nvm的文件夹内增删对应版本的node文件夹。

导入node压缩包步骤：

下载对应的node版本的zip压缩包，解压到nvm的文件夹下，文件夹命名为v<版本号>（如v20.16.0，注意文件夹不是存放在 node_global 文件夹，存放路径参照环境变量里面的 NVM_HOME 的路径）

node官方各版本的压缩包或安装包下载地址：

Index of /download/release/

https://nodejs.org/download/release/

4、切换nvm

nvm一切配置成功，且下载至少一个node版本之后，使用命令nvm list查看当前已安装所有node版本，使用命令nvm use <版本号>切换到对应node版本，切换node版本的同时也会自动切换对应的npm版本。

如果你安装的node版本不多，可以用大版本简称，比如20版本只装了20.16.0，可以用nvm use 20代指nvm use 20.16.0 如果你想要打开某项目时自动切换到某个node版本，网上有一些编译器插件，可以自行搜索(反正我是没配置好)

5、npm配置

在 C:\Users\<用户名> 路径下创建 .npmrc 文件，在其中写入你的 npm 配置项，如

将设置的prefix目录，添加到系统变量的path(高级系统设置→环境变量→系统变量→path)中，然后重新启动系统以刷新并应用系统变量。这样可以使全局安装的包的命令在任意终端中执行，如添加此变量后，执行 npm i pnpm -g 可全局安装pnpm，可全局使用pnpm。

6、pnpm配置

在执行完上述步骤后，打开终端执行 pnpm -v ，若出现版本号则表示环境正常。之后可在终端中执行下方的命令：

同npm配置，将 D:\nvm\node\pnpm-store\ 目录添加到系统变量的path(高级系统设置→环境变量→系统变量→path)中，然后重新启动系统以刷新并应用系统变量。这样可以使全局安装的包的命令在任意终端中执行。