Window / Mac 系统 nvm 安装使用指南

最近给家里电脑重装系统,都重新安装了 nvm,就记录了一下,也方便大家避坑

简介

nvm 是什么?和 npm 是什么关系?

  • npm:是 nodejs 包的管理工具,在安装 node 的时候,npm 也会自动一起安装,因为每个 node 版本都有对应的 npm 版本
  • nvm:是 node 版本管理工具,可以同时在电脑上安装多个不同版本 node,可以非常方便的操作 node 不同版本的切换、安装、查看等等

nvm 的好处?

比如你电脑上可能跑多个项目的时候,且不同项目所需 node 版本不一致时;

比如升级了项目的 node 版本,结果发现有问题,需要再换回之前的版本时;

如果每次都卸载电脑上的 node 再去下载新的版本,可就太坑了,所以 nvm 来了,直接一条命令让我们切换不同的 node 版本,非常方便

如果你的电脑已经安装了 node,那么在安装 nvm 之前要先卸载掉,避免后面产生不必要的冲突

Window 控制面板程序卸载或者用其他的应用卸载都行

Mac 卸载:

# 删除全局 node_modules 目录
sudo rm -rf /usr/local/lib/node_modules
# 删除 node
sudo rm /usr/local/bin/node 
# 删除全局 node 模块注册的软链
cd /usr/local/bin && ls -l | grep "../lib/node_modules/" | awk '{print $9}'| xargs rm

Mac 安装 nvm

Mac nvm 文档

安装命令

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

或者

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.2/install.sh | bash

命令中的 v0.39.2 是版本号,是 Mac 当前最新版,如果需要安装不同版本,修改这里即可

安装完成后,在命令行窗口输入 nvm 回车,安装成功会出现满满一页的各种信息,如果只有 nvm: command not found,就说明没安装成功

没安装成功的话,执行 echo $0 命令,看下当前的 shellbash 还是 zsh

如果是 bash 安装失败基本是没有 .bash_profile 这个文件,可以使用 open .bash_profile 命令打开这个文件试下,打不开就说明没有,那么执行下面命令创建一个,再重新执行上面的安装命令即可

# 创建 .bash_profile 文件
touch ~/.bash_profile

如果是 zsh,那就打开 open .zshrc 文件,在里面添加一行 source ~/.bash_profile,如果打不开这个文件,就先创建一个,再添加,再重新执行上面的安装命令即可

# 创建 .zshrc 文件
touch ~/.zshrc
# 创建完成,再打开,在里面添加这个
source ~/.bash_profile

安装成功后怎么使用,请继续看

Window 安装 nvm

nvm 下载地址

在下载页面找到如图所示下载即可:

安装过程中一路点下一步的话就到 C 盘了(也可以自定义目录),到这里执行 nvm 命令肯定不会失败,接下来就安装 node 就行了,比如安装 16.16.0 这个版本的 node 就执行如下命令,如下版本号前加不加 v 是一模一样的

# nvm install v16.16.0
nvm install 16.16.0

注意这里的 install 不能省略成 i,会报错

安装有可能失败,也有可能成功,也有可能成功一半,成功一半的意思是 node 安装成功,但是 npm 安装失败,终端不会提示这个失败信息,只是在安装完成后输入 node -v 有值,npm -v 就报错

所以建议在使用 nvm install xxxx 之前,先打开 nvm 安装目录下的 settings.text 如图:

在该文件里添加下面两行代码,然后保存。表示使用淘宝境像安装 node 和 npm,再运行 nvm install xxxx 即可,就不会安装失败了

node_mirror:npm.taobao.org/mirrors/node/
npm_mirror:npm.taobao.org/mirrors/npm/

如果不想用淘宝镜像,也可以放心。这里的淘宝镜像只是针对 nodenpm 这两个东西的安装,不是项目中的 npm i xxx 也用淘宝镜的意思,项目中的需要另外配置,项目中使用淘宝镜像如下:

# npm 用淘宝镜像
npm config set registry http://registry.npm.taobao.org/
# 或安装 cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm config  set registry https://registry.npm.taobao.org
cnpm config get registry
cnpm -v

如果你不想用淘宝镜像,却出现安装了 node 却没有 npm 的问题,那只能手动安装 npm,如下

先查看 node 不同版本对应 npm 版本号:点击前往

再去下载对应的 npm 版本的 zip 文件:点击前往

下载好之后:

  • 把解压出来的文件夹(cli-xxxx)重命名为 npm
  • 放入对应 node 版本下的 node_modules 文件夹里面
  • 然后打开该 npm 文件夹里的 bin 文件夹,把里面的 npm 文件npm.cmd 文件 复制,放到对应 node 版本下,和 node_modules 文件夹同级即可

上面操作完成之后,执行 node -vnpm -v 就都有了

接着需要执行 nvm on 命令来开启使用 nvm 来管理 node,如果这个命令报错,请打开管理员模式的 cmdpowershell,再执行 nvm on 即可

nvm 常用命令

比较常用的几个命令,注意看下注释

nvm install <版本号> // 安装指定 node 版本,版本号如写 14.5.0 或 v14.5.0 效果一样
nvm uninstall <版本号> // 卸载指定 node 版本
nvm install stable // 安装最新稳定版 node
nvm ls // 查看已经安装了的所有 node 版本
nvm on // 开启使用 nvm 管理 node
nvm use <版本号> // 切换到指定 node 版本
nvm alias default <版本号> // 如果 nvm use xxx 换不了,就用这个换
nvm off // 关闭 nvm 管理 node

修改 npm 全局目录及环境变量

Window 下可以使用 npm root -g 命令查看默认全局安装目录,大概是这样的

C:\Users\Administrator\AppData\Roaming\npm\node_modules

如果想把全局目录和缓存文件单独放到其他地方方便区分管理,且不占 C 盘的话,可以自己随意在其他盘新建目录,比如有如下目录结构用来存放

D:
└─node
 ├─node_cache
 └─node_global
 └─node_modules

先执行如下两条命令修改默认 npm 全局安装路径,和安装过程缓存文件存储路径

# 上面的路径,如下,如果设置失败看后面的后续处理第 1 条
npm config set prefix 'D:/node/node_global'
npm config set cache 'D:/node/node_cache'
# 然后输入下面这个命令查看是否修改成功
npm config ls

然后配置环境变量即可

在用户或系统变量 path 里添加:D:/node/node_global

在系统变量添加 NODE_PATHD:/node/node_global/node_modules

安装后续错误处理

只是 windows 会存在如下问题

npm 安装插件报错或设置 npm 全局路径报错

npm ERR! Please try running this command again as root/Administrator

解决方案:

删除 .npmrc 文件,文件位置:C:\Users\{账户}\.npmrc,有些电脑没有 Users 文件夹的,而是中文的【用户】文件夹,是一样的

安装好的东西不能加载

比如 npm i yarn -g 安装成功后,我再执行 yarn -v 报错如下

yarn : 无法加载文件 xxxx\node_global\yarn.ps1,因为在此系统上禁止运行脚本。有关详细信息,请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。

原因是没有权限

解决方案:

  • 先打开 powershell,找不到的话可以通过 vscode 打开 powershell
  • 然后执行 get-ExecutionPolicy 命令,是查看权限的
  • 输出结果为 Restricted,说明权限是禁用的
  • 接着执行 set-ExecutionPolicy -Scope CurrentUser 命令
  • 会提示输入,然后输入 remotesigned 回车,设置成可用的意思
  • 再执行 get-ExecutionPolicy 命令,结果为 RemoteSigned 表示更改成功,然后就可以正常加载了

到这,nvmnodenpm 安装到正常使用应该都没啥问题了,如有遗漏,欢迎评论区留言指出

结语

如果本文对你有一点点帮助,点个赞支持一下吧,你的每一个【赞】都是我创作的最大动力 ^_^

更多前端文章,或者加入前端交流群,欢迎关注公众号【前端快乐多】,大家一起共同交流和进步呀

作者:沐华原文地址:https://segmentfault.com/a/1190000042798472

%s 个评论

要回复文章请先登录注册