macOS 使用 NVM 升级 Node.js 完整操作

完整规范的升级 Node.js 操作


📝 macOS 使用 NVM 升级 Node.js 完整操作


一、问题描述

在 macOS 系统中,使用 nvm install node 升级 Node.js 时遇到错误:

arduino 复制代码
Version 'node' not found - try `nvm ls-remote` to browse available versions.

同时执行 nvm ls-remote 仅能列出 iojs 相关版本,缺失正常的 Node.js 版本(如 v18、v20系列)。


二、原因分析

综合排查后,发现可能原因有以下几种:

可能原因 说明
1. nvm 未正确加载 当前终端未加载 nvm 环境变量或初始化脚本。
2. 网络连接问题 无法访问 Node 官方源(nodejs.org/dist),导致版本列...
3. 镜像源配置问题 nvm 默认从 Node 官网拉取数据,国内访问有时被墙或连接异常。

三、解决方案

1. 确保 nvm 正确加载

在终端执行以下命令,手动加载 nvm 环境变量:

bash 复制代码
export NVM_DIR="$HOME/.nvm"
source "$NVM_DIR/nvm.sh"

验证 nvm 是否加载成功:

css 复制代码
nvm --version

若能正确输出版本号(如 0.39.7),说明 nvm 已正常加载。


2. 设置国内镜像源(推荐淘宝 npmmirror)

由于访问 Node 官方源不稳定,推荐使用淘宝 Node 镜像。

执行以下命令,切换镜像源:

arduino 复制代码
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

再次执行:

复制代码
nvm ls-remote

如果能正常列出 Node 版本列表(如 v18.17.1, v20.12.2 等),说明切换成功。


3. 安装最新 Node.js

安装最新稳定版 Node.js:

复制代码
nvm install node

设置为默认版本:

csharp 复制代码
nvm alias default node
nvm use node

查看安装完成后的版本:

复制代码
node -v
npm -v

4. (可选)永久配置到 Shell 配置文件

为了避免每次手动配置,推荐将镜像源和 nvm 初始化写入 ~/.zshrc~/.bashrc 文件中。

编辑配置文件:

bash 复制代码
nano ~/.zshrc

添加以下内容:

bash 复制代码
export NVM_DIR="$HOME/.nvm"
source "$NVM_DIR/nvm.sh"
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

保存并重新加载配置:

bash 复制代码
source ~/.zshrc

这样以后打开终端就能直接使用 nvm 和国内镜像了。


四、最终验证

执行以下命令确认安装成功:

bash 复制代码
node -v
npm -v
nvm ls

确保显示的是新安装的 Node.js 版本。


✅ 总结

本次问题的根因在于网络环境导致 nvm 无法访问 Node 官方源,只能看到 iojs 版本。通过切换到淘宝 Node 镜像源,并正确加载 nvm 环境,最终成功完成了 Node.js 升级。


相关推荐
Jacob02341 小时前
Node.js 性能瓶颈与 Rust + WebAssembly 实战探索
后端·rust·node.js
Wang's Blog5 小时前
Nestjs框架: Node.js 多环境配置策略与 dotenv 与 config 库详解
node.js
濮水大叔6 小时前
Prisma不能优雅的支持DTO,试试Vona ORM吧
前端框架·node.js·orm
啃火龙果的兔子8 小时前
Node.js (Express) + MySQL + Redis构建项目流程
mysql·node.js·express
WindrunnerMax10 小时前
浅谈 RAG 并基于 NodeJS 实现基础向量检索服务
架构·node.js·aigc
香蕉可乐荷包蛋10 小时前
node.js常用函数
node.js
萌萌哒草头将军1 天前
🚀🚀🚀 深入探索 Node.js v22.18.0 新特性;默认支持运行 ts 文件了!
前端·typescript·node.js
yzzzzzzzzzzzzzzzzz1 天前
Node.js 操作 MySQL
数据库·mysql·node.js
子壹1 天前
大文件分片上传
javascript·node.js
五月君_1 天前
见证历史:Vite 首次超越 Webpack!
前端·webpack·node.js