MacBook安装nvm管理Node.js多版本命令详细讲解

 更新时间:2026年05月11日 10:00:47   作者:1telescope  
刚接触前端开发时,我经常被不同项目对Node.js版本的依赖搞得焦头烂额,直到发现了NVM这个神器,才真正解决了版本切换的痛点,这篇文章主要介绍了MacBook安装nvm管理Node.js多版本的相关资料,需要的朋友可以参考下

一、概述

nvm(Node Version Manager)是MacOS下管理Node.js多版本的主流工具,可一键安装、切换、卸载不同Node版本,自动配置环境变量,无需手动修改系统配置。

二、前置条件

  • MacBook 已安装 Git(新Mac默认自带,若未安装可通过 xcode-select --install 安装Xcode Command Line Tools)。
  • 知晓当前使用的Shell类型(MacOS默认是zsh,可通过 echo $SHELL 查看)。

三、安装 nvm

1. 执行安装命令

打开终端(Terminal),执行以下命令安装最新版nvm:

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

若curl访问失败,改用wget:

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

2. 检查自动配置(关键步骤)

nvm安装时会自动将环境变量配置写入Shell配置文件(zsh对应~/.zshrc,bash对应~/.bash_profile/~/.bashrc),无需手动添加:

  1. 打开配置文件检查:
    # zsh用户
    open ~/.zshrc
    # bash用户
    open ~/.bash_profile
    
  2. 确认文件中包含以下内容(有则无需重复添加):
    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
    [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
    

3. 使配置生效

执行以下命令让配置立即生效:

# zsh用户
source ~/.zshrc
# bash用户
source ~/.bash_profile

4. 验证nvm安装成功

执行命令查看nvm版本,输出版本号即安装成功:

nvm --version
# 示例输出:v0.39.7

四、使用 nvm 管理 Node.js 版本

1. 安装Node版本

操作命令示例
安装最新版nvm install node
安装指定版本nvm install 18.18.0
安装LTS(长期支持)版nvm install --lts

2. 查看已安装版本

nvm ls
# 输出示例:
#       v16.20.2
# ->    v18.18.0
#        v20.9.0
# default -> 18.18.0
# node -> stable (-> v20.9.0)
# lts/* -> lts/iron (-> v20.9.0)

3. 切换Node版本

操作命令示例
切换到指定版本nvm use 18.18.0
切换到LTS版nvm use --lts
切换到最新版nvm use node

4. 设置默认版本(推荐)

避免每次打开终端重新切换版本,设置默认版本:

nvm alias default 18.18.0

5. 卸载指定版本

nvm uninstall 18.18.0

五、验证Node环境

切换版本后,执行以下命令确认版本生效:

node -v  # 输出当前Node版本,如v18.18.0
npm -v   # 输出对应npm版本,如9.8.1

若版本未更新,重启终端即可(环境变量重新加载)。

六、常见问题解决

  1. 执行nvm --version提示command not found: nvm
    • 重启终端重试;
    • 重新执行nvm安装脚本;
    • 检查Shell配置文件是否有nvm配置,无则手动添加。
  2. 切换版本后node -v无变化:
    • 确认执行了nvm use <版本号>
    • 重启终端或执行source ~/.zshrc(zsh用户)。

总结 

到此这篇关于MacBook安装nvm管理Node.js多版本命令的文章就介绍到这了,更多相关Mac安装nvm管理Node.js多版本内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • node.js中的buffer.Buffer.byteLength方法使用说明

    node.js中的buffer.Buffer.byteLength方法使用说明

    这篇文章主要介绍了node.js中的buffer.Buffer.byteLength方法使用说明,本文介绍了buffer.Buffer.byteLength的方法说明、语法、接收参数、使用实例和实现源码,需要的朋友可以参考下
    2014-12-12
  • 图文详解如何完全卸载旧的nodejs

    图文详解如何完全卸载旧的nodejs

    在开发过程中,Node.js 成为了许多开发者的首选工具,然而有时出于各种原因,我们可能需要卸载它,卸载 Node.js 不仅仅是删除其安装程序那么简单,还需要清理相关文件和环境变量,这篇文章主要介绍了如何完全卸载旧nodejs的相关资料,需要的朋友可以参考下
    2025-09-09
  • Node.js中npm 和 peerDependencies的使用

    Node.js中npm 和 peerDependencies的使用

    本文详细介绍了npm中的peerDependencies和--legacy-peer-deps使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-01-01
  • Node连接mysql数据库方法介绍

    Node连接mysql数据库方法介绍

    本篇文章主要介绍了Node连接mysql数据库方法介绍。详细的介绍了怎样连接和操作数据库,并举例说明,有兴趣的可以了解一下。
    2017-02-02
  • 关于node-bindings无法在Electron中使用的解决办法

    关于node-bindings无法在Electron中使用的解决办法

    今天小编就为大家分享一篇关于关于node-bindings无法在Electron中使用的解决办法,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2018-12-12
  • Nodejs中的JWT和Session的使用

    Nodejs中的JWT和Session的使用

    这篇文章主要介绍了Nodejs中的JWT和Session的使用,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-08-08
  • nodejs中安装ghost出错的原因及解决方法

    nodejs中安装ghost出错的原因及解决方法

    本篇文章主要介绍了nodejs中安装ghost出错的原因及解决方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-10-10
  • nodejs实现HTTPS发起POST请求

    nodejs实现HTTPS发起POST请求

    这篇文章主要介绍了nodejs实现HTTPS发起POST请求的实例代码,非常的简单实用,有需要的小伙伴可以参考下。
    2015-04-04
  • Node.js Process对象详解

    Node.js Process对象详解

    本文详细讲解了Node.js Process对象,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-08-08
  • Node.js重新刷新session过期时间的方法

    Node.js重新刷新session过期时间的方法

    在Node.js中,我们通常使用express-session这个包来使用和管理session,保存服务端和客户端浏览器之间的会话状态。那如何才能实现当用户刷新当前页面或者点击页面上的按钮时重新刷新session的过期时间呢,接下来通过本文一起学习吧
    2016-02-02

最新评论