推荐使用nvm安装任意历史版本(如v14.21.3),或homebrew版本化公式(如node@16)安装长期支持主版本;nvm灵活适合多项目,homebrew适合系统级固定需求。
在 macos 上安装指定的历史版本 node.js,核心是选对工具和方法。直接用 brew install node 只能装最新版;要装历史版本(比如 v14.21.3、v16.20.2 或 v18.19.0),推荐两种可靠路径:用 nvm(最灵活常用)或用 homebrew 的版本化公式(适合系统级固定需求)。下面分情况说明关键操作。
用 nvm 安装任意历史版本(推荐)
nvm 是用户级版本管理器,所有版本独立存放在 ~/.nvm/versions/node/,不干扰系统 PATH,切换快、卸载干净,特别适合多项目并行开发。
- 先安装 nvm(若未装):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
然后执行source ~/.zshrc(macOS Catalina 及以后默认用 zsh) - 查看所有可安装的远程版本(含已归档的旧版):
nvm ls-remote
输出里会列出从 v0.1.14 到最新的全部版本,支持模糊搜索,例如:nvm ls-remote | grep "v14.21" - 安装具体历史版本(如 v14.21.3):
nvm install 14.21.3
安装完成后自动设为当前版本 - 验证:
node -v→ 输出v14.21.3nvm current→ 显示当前激活版本
用 Homebrew 安装长期维护的旧主版本(如 v14/v16/v18)
Homebrew 提供带主版本号的“版本化公式”(formulae),比如 node@14、node@16,它们对应各自主版本的最新 LTS 小版本(非任意 patch 版)。适用于需要稳定系统级 Node 环境的场景。
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流:PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景:(1) "安装我的自动化服务",(2) "部署所有 Automato...
- 搜索可用的版本化公式:
brew search node@
常见结果:node@14、node@16、node@18、node@20(截至 2026 年,node@14已 EOL,但 brew 仍保留公式供安装) - 安装指定公式(如 v16):
brew install node@16 - 手动链接到系统路径(关键!否则
node命令不可用):brew unlink nodebrew link --force node@16 - 补充 PATH(更稳妥的做法,尤其 Apple Silicon):
把这行加到~/.zshrc:export PATH="/opt/homebrew/opt/node@16/bin:$PATH"
再运行source ~/.zshrc
不推荐但可行:官网下载旧版 .pkg 安装包
Node.js 官网只保留最近两个 LTS 版本的下载入口,更老的版本需访问官方归档页:
- 打开 https://www.php.cn/link/726c44e5b573700a55d76d4e8dde9044
- 找到目标版本目录(如
v14.21.3/),下载node-v14.21.3.pkg - 双击安装 —— 它会覆盖写入
/usr/local/bin/,可能与 brew 或 nvm 冲突 - 安装后建议检查冲突:
which node和ls -l $(which node),确认是否符合预期
验证与切换小贴士
装完别急着写代码,先确认环境干净:
- 运行
node -v、npm -v看输出是否匹配目标版本 - 如果仍显示旧版本,大概率是 shell 缓存了 PATH 或多个 Node 共存冲突,可尝试:
hash -d node(清除命令哈希)
再重新开一个终端窗口 - nvm 用户可随时切换:
nvm use 16.20.2(临时)nvm alias default 16.20.2(设为默认)










