MacOS上安装nvm

1. 前言

Node Version Manager (NVM) 是一种广泛使用的工具,允许开发人员在单台计算机上管理 Node.js 的多个版本。它的重要性怎么强调都不为过,因为 Nodejs 应用程序有时可能是依赖特定版本运行,然而不同的项目可能需要不同的 Nodejs 版本。NVM 提供的灵活性确保了不同项目同时运行在同一台机的开发过程的顺利进行,允许开发人员在 Node 版本之间无缝切换。在 macOS 上,有多种安装 NVM 的方法,但最流行、最有效的方法之一是使用 Homebrew,这是 macOS 著名的包管理器。

本指南将引导您完成使用 Homebrew 在 macOS 上安装 NVM 的详细步骤,让您轻松设置灵活的 Node.js 开发环境。

2. 先决条件

  • 需要拥有管理员权限
  • 如果尚未安装 Homebrew,可以参考我的博客Macos开发环境配置中关于配置Homebrew部分.

3. 删除现有Nodejs版本

如果您的系统已经安装了节点,请先将其卸载。我的系统已经通过 Homebrew 安装了节点。所以先卸载它。如果尚未安装,请跳过。

1
2
3
4

brew uninstall --ignore-dependencies node
brew uninstall --force node

如果是通过pkg安装包安装的, 可以参考我的博客安装并配置nodejs尾部”在MacOS上卸载nodejs”章节所述的方法删除Nodejs.

4. 在macOS上安装NVM

在安装任何软件包之前,最好将 Homebrew 更新到最新.

1
brew update 

之后,您可以使用以下命令轻松安装 NVM:

1
brew install nvm 

接下来,在用户主目录中创建一个 .nvm 目录

1
mkdir ~/.nvm 

现在,配置所需的环境变量。在用户主目录中编辑以下配置文件

注意: 在配置nvm前, 先确定一下当前用户的Shell类型
echo $SHELL, 如果是bash, 则按bash的配置方式, 如果是zsh则参照zsh的配置方式.

1
vim ~/.bash_profile 

将以下行添加到~/.bash_profile(或 ~/.zshrc 对于 macOS Catalina 或更新版本)

1
2
3
4
5
6
7
8

# 配置NVM_DIR
export NVM_DIR="$HOME/.nvm"
# 加载nvm相关命令
[ -s "/usr/local/opt/nvm/nvm.sh" ] && \. "/usr/local/opt/nvm/nvm.sh"
# 加载nvm命令补全配置
[ -s "/usr/local/opt/nvm/etc/bash_completion" ] && \. "/usr/local/opt/nvm/etc/bash_completion"

接下来,将变量加载到当前 shell 环境。从下次登录开始,它会自动加载。

1
2
3

source ~/.bash_profile # 或源 ~/.zshrc

就是这样。NVM 已安装在您的 macOS 系统上。转到下一步,在 nvm 的帮助下安装 Node.js 版本。

5. 使用 NVM

首先,查看可以安装哪些 Node 版本。要查看可用版本,请键入:

1
2
3

nvm ls-remote

现在,您可以安装上面输出中列出的任何版本。您还可以使用别名,例如node表示最新版本,lts表示最新 LTS 版本等。

1
2
3
4
5

# 安装最新版本node
nvm install node ## 安装最新版本
# 或者
nvm install 17 ## 安装 Node.js 17.X 版本

安装后,可以验证安装的内容:

1
nvm ls 

如果您的系统上安装了多个版本,您可以随时将任何版本设置为默认版本。要将节点 17.X 设置为默认版本,只需使用:

1
2
3
4
5
6
7
8
9
10

# 在当前session中有效
nvm use 17

# 要让版本切换永久有效
nvm alias default 17

# 或者使用指定版本的 nodejs
nvm alias default v17.9.0

同样,您可以安装其他版本(例如 Node 12、15 和 18 版本)并在它们之间切换。

6. 配置Nodejs

由于不知名的原因, 国内访问npm仓库会很慢, 所以需要设置镜像, 淘宝为我们提供了很好的镜像源.

1
2
3
4
5
6
7
8
9
10
设置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 或者使用华为镜像
# npm config set registry https://mirrors.huaweicloud.com/repository/npm/
# 或者使用腾讯镜像
# npm config set registry http://mirrors.cloud.tencent.com/npm/
// 配置后可通过下面方式来验证是否成功
npm config get registry
// 或
npm info express

7. 说明

本文原文位于鹏叔的技术博客 - MacOS上安装nvm, 获取最近更新, 请访问原文.

最新更新以及更多Nodejs相关文章请访问 鹏叔的技术博客 - Nodejs

8. 总结

拥有管理和在各种Node.js版本之间切换的能力对于现代web开发至关重要,而NVM提供了这种灵活性。通过在macOS上利用Homebrew,安装过程变得简化,使NVM比以往任何时候都更容易启动和运行。安装后,开发人员可以享受轻松的体验,无论其版本要求如何,都可以处理多个Node.js项目。
本指南为您提供了使用Homebrew在macOS上安装NVM所需的所有知识。现在,你已经准备好处理任何Node.js项目了,因为你知道你有能力在指尖轻松管理和切换Node版本。

9. 参考文档

How To Install NVM on macOS with Homebrew

作者

鹏叔

发布于

2023-08-23

更新于

2024-07-10

许可协议

评论