跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.js大前端

MacBook 安装 nvm 管理 Node.js 多版本教程

综述由AI生成在 macOS 系统上安装和使用 nvm 工具管理 Node.js 多版本的方法。步骤涵盖环境准备、通过脚本安装 nvm、配置 Shell 环境变量、验证安装,以及具体的 Node.js 版本安装、切换、默认设置和卸载操作。文末还列出了常见错误排查方案,帮助开发者快速搭建 Node.js 开发环境。

CloudNative发布于 2026/3/27更新于 2026/5/30810 浏览
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),无需手动添加:

确认文件中包含以下内容(有则无需重复添加):

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

打开配置文件检查:

# zsh 用户
open ~/.zshrc
# bash 用户
open ~/.bash_profile
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 用户)。

目录

  1. 一、概述
  2. 二、前置条件
  3. 三、安装 nvm
  4. 1. 执行安装命令
  5. 2. 检查自动配置(关键步骤)
  6. zsh 用户
  7. bash 用户
  8. 3. 使配置生效
  9. zsh 用户
  10. bash 用户
  11. 4. 验证 nvm 安装成功
  12. 示例输出:v0.39.7
  13. 四、使用 nvm 管理 Node.js 版本
  14. 1. 安装 Node 版本
  15. 2. 查看已安装版本
  16. 输出示例:
  17. v16.20.2
  18. -> v18.18.0
  19. v20.9.0
  20. default -> 18.18.0
  21. node -> stable (-> v20.9.0)
  22. lts/* -> lts/iron (-> v20.9.0)
  23. 3. 切换 Node 版本
  24. 4. 设置默认版本(推荐)
  25. 5. 卸载指定版本
  26. 五、验证 Node 环境
  27. 输出当前 Node 版本,如 v18.18.0
  28. 输出对应 npm 版本,如 9.8.1
  29. 六、常见问题解决
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 自然语言处理在金融领域的实战应用
  • Java 快速集成 Dify AI 平台实践
  • LLM 训练详解:从预训练到微调与大模型应用
  • 大模型产品经理转型指南:从零开始的全面路径
  • 开源 Remix Icon 图标库使用指南
  • Java I/O 操作详解
  • Python 爬虫逆向:网易易盾滑块验证码请求参数分析
  • Java Map 和 Set 数据结构详解与对比
  • PostCSS px-to-viewport 移动端适配实战指南
  • 从 Java 到 Kotlin 语法平滑迁移指南
  • HarmonyOS 视频封面智能生成实战与 AI 集成
  • FANUC 机器人 PR 寄存器详解:定义、操作与实战
  • OpenDroneMap 快速入门:无人机影像处理与三维建模
  • AI 生成 UI 缺乏设计感?三步提升前端页面质感
  • AIGC 驱动制造业生产力变革:从报告生成到代码自动化
  • ToClaw:零门槛体验 OpenClaw AI 桌面自动化能力
  • Python 列表与元组的区别及常用操作
  • C++ 模板的幻觉:实例化、重定义与隐藏依赖
  • IDEA 配置 Maven 详细教程
  • iStoreOS 配置网络 IPv4 及 IPv6

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online