很多 mac 用户需要配置 nodejs 的包版本管理工具 npm,而 nvm 则是能够针对 nodejs 和 npm 版本进行管理的工具,本文将介绍如何在 mac 上配置 nvm。

以下是 nodejs 和 nvm 官方安装文档的链接:
nodejs 官方安装文档
nvm 官方安装文档

各位可以自己去查看文档,根据文档的教程进行安装,本文将详细说明我的安装步骤。

安装 nvm

打开终端(Terminal),输入以下命令安装 nvm:

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

若成功安装,则显示以下信息:

一般情况下,这个时候就已经安装好了 nvm,但部分用户可能会遇到 nvm 命令无法识别的问题,这是因为环境配置自动完成,所以需要手动配置环境变量。

输入以下命令查看 nvm 是否安装(配置)成功:

1
nvm -v

如果成功安装,则会输出 nvm 的版本号,若未成功安装,则会提示 command not found: nvm

配置环境变量

如果 nvm 命令无法识别,则需要手动配置环境变量。

打开终端,输入一下命令查看 nvm 是否已经安装成功:

1
ls -a ~ | grep .nvm

如果显示 .nvm,则表示 nvm 已经安装成功。如果未显示 .nvm,则表示 nvm 未安装成功,需要重新执行安装命令。

接着,我们要先知道自己电脑的 Shell 配置文件是什么,输入以下命令:

1
echo $SHELL

一般情况下,mac 的 Shell 配置文件是 ~/.bash_profile~/.zshrc,如果输出的是 zsh,则表示 Shell 配置文件是 ~/.zshrc;如果输出的是 bash,则表示 Shell 配置文件是 ~/.bash_profile

我的输出是 zsh,所以我的 Shell 配置文件是 ~/.zshrc。以下就以 ~/.zshrc 为例进行说明。

我们可以输入以下命令来打开 ~/.zshrc 文件:

1
2
3
4
5
open -e ~/.zshrc # macOS 自带的文本编辑器打开
# 或者
vim ~/.zshrc # 使用 vim 打开
# 或者
nano ~/.zshrc # 使用 nano 打开

我这里使用 vim 打开,并对 vim 的部分操作命令进行说明。

在终端中输入 vim ~/.zshrc,打开 ~/.zshrc 文件。

此时按下 i 键,进入插入模式,可以编辑文件内容。并将以下命令添加到文件末尾:

1
2
3
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 加载 nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # 加载自动补全

编辑完成后,按下 Esc 键,退出插入模式。然后输入 :wq,按下回车键,保存并退出 vim。

此时,重新打开一个终端窗口,输入以下命令查看 nvm 是否安装成功:

1
nvm -v

如果成功安装,则会输出 nvm 的版本号。

安装 nodejs

现在,我们就可以跟着 nodejs 官方文档安装 nodejs 了。你可以选择安装最新的 LTS 版本,或者最新的 Current 版本,也可选择自己需要的版本进行安装。

输入以下命令查看可安装的 nodejs 版本:

1
nvm ls-remote

接着就是选择自己需要的版本进行安装,比如我选择安装最新的 LTS 版本 v22.19.0,则输入以下命令:

1
nvm install 22

安装完成后,输入以下命令查看 nodejs 版本:

1
node -v

如果成功安装,则会输出 nodejs 的版本号。

配置 npm

安装完 nodejs 后,npm 就已经自动配置完成,可以输入 npm -v 查看 npm 版本。