一、安装前准备
-
卸载已存在的 Node.js
- 若已安装过 Node.js,需先彻底卸载,避免版本冲突18。
- 执行以下命令删除全局 Node 模块和可执行文件:
sudo rm -rf /usr/local/lib/node_modules
sudo rm /usr/local/bin/node
cd /usr/local/bin && ls -l | grep "../lib/node_modules/" | awk '{print $9}' | xargs sudo rm
二、安装方法(任选其一)
方法一:通过 Homebrew 安装(推荐)
- 安装 Homebrew
- 执行官方命令安装(需科学上网):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 国内用户可使用镜像源加速安装:
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
- 通过 Homebrew 安装 nvm
- 执行命令
brew install nvm
- 配置环境变量
- 编辑
~/.zshrc
文件(默认Shell为zsh),可以添加以下内容
export NVM="$HOME/.nvm"
- 保存执行
source ~/.zshrc
使配置生效
方法二:通过curl脚本安装
- 直接安装nvm
- 执行命令
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
- 配置环境变量
- 编辑
~/.zshrc
或~/.bash_profile
文件(默认Shell为zsh),可以添加以下内容:
export NVM="$HOME/.nvm"
- 保存执行
source ~/.zshrc
使配置生效
三、验证安装
- 执行以下命令,检查安装是否成
nvm --version // 显示版本号即安装成功
四、基本使用命令
- 安装Node.js
nvm install node // 安装最新的稳定版本
nvm install 20.0.0 // 安装指定版本
- 切换版本
nvm use node // 使用最新版本
nvm use 20.0.0 // 切换至指定版本
- 查看已安装版本及设置默认版本
nvm ls // 列出所有版本
nvm current // 显示当前使用版本
- 设置默认版本
nvm alias default v20.0.0 // 输出 default -> v20.19.0 (-> N/A)即表示设置成功
- 验证默认版本
- 重新打开终端或执行
source ~/.zshrc // 若使用 zsh(默认 Shell)
- 卸载指定版本
nvm uninstall 20.0.0 // 列出所有版本
五、常见问题
- 安装后提示
conmmand not found: nvm
****
检查环境变量配置是否正确,并确保执行source ~/.zshrc
- 网络问题导致安装失败
尝试切换镜像源或修改hosts文件