在 macOS 上使用 Homebrew 安装 Node.js 的完整指南(最新推荐)

更新时间：2026年04月01日 09:30:47 作者：John Song

本文介绍了使用Homebrew在macOS上安装、验证、升级、切换和卸载Node.js的方法,包括安装最新稳定版、安装特定版本、配置环境变量、使用n或nvm管理多个版本等内容,感兴趣的朋友跟随小编一起看看吧

1. 准备工作

首先确保你已经安装了 Homebrew（macOS 上最流行的包管理器）：

# 检查是否已安装 Homebrew
brew --version
# 如果未安装，使用以下命令安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js

方法一：安装最新稳定版（推荐）

brew install node

方法二：安装特定版本

# 先搜索可用的 Node.js 版本
brew search node
# 安装特定版本（如 18.x）
brew install node@18

3. 安装后的验证

# 检查 Node.js 版本
node -v
# 检查 npm 版本
npm -v
# 检查 npx 版本
npx -v

4. 环境变量配置（仅当安装特定版本时需要）

如果你安装了特定版本的 Node.js（如 node@18），需要手动添加环境变量：

# 对于 bash/zsh 用户
echo 'export PATH="/usr/local/opt/node@18/bin:$PATH"' >> ~/.zshrc
# 然后重新加载配置文件
source ~/.zshrc

5. 升级 Node.js

# 先更新 Homebrew
brew update
# 然后升级 Node.js
brew upgrade node

6. 切换 Node.js 版本（可选）

如果你需要管理多个 Node.js 版本，可以使用 n 或 nvm：

使用 n 管理版本

# 安装 n
npm install -g n
# 安装特定版本
n 16.13.0
# 切换版本
n

使用 nvm 管理版本

# 安装 nvm
brew install nvm
# 然后按照提示配置环境变量
# 使用 nvm 安装和管理版本
nvm install 14
nvm use 14

7. 卸载 Node.js

# 卸载 Node.js
brew uninstall node
# 如果需要彻底删除残留文件
rm -rf /usr/local/lib/node_modules
rm -rf ~/.npm

常见问题解决

权限问题：如果遇到权限错误，可以尝试：

sudo chown -R $(whoami) $(brew --prefix)/*

命令未找到：确保 Homebrew 的路径已添加到你的 shell 配置文件中：

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

版本不匹配：如果 node 和 npm 版本显示不一致，可以尝试：

brew postinstall node

通过 Homebrew 安装 Node.js 是最简单、最推荐的方式，它能自动处理依赖关系并方便后续升级管理。

到此这篇关于在 macOS 上使用 Homebrew 安装 Node.js 的完整指南(最新推荐)的文章就介绍到这了,更多相关Homebrew 安装 Node.js 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Nodejs在局域网配置https访问的实现方法
做一个局域网WebRTC视频聊天系统，需要用到HTTPS。因此，配置Node.js使其支持HTTPS访问。这篇文章主要介绍了Nodejs在局域网配置https访问的实现方法,需要的朋友可以参考下
2020-10-10
关于Mac下安装nodejs、npm和cnpm的教程
本文通过图文并茂的形式给大家介绍了Mac下安装nodejs、npm和cnpm的教程，非常不错，具有参考借鉴价值，需要的朋友参考下吧
2018-04-04
nodeJs实现基于连接池连接mysql的方法示例
这篇文章主要介绍了nodeJs实现基于连接池连接mysql的方法,结合具体实例形式分析了nodejs连接池操作mysql数据库连接的实现与使用技巧,需要的朋友可以参考下
2018-02-02
使用travis-ci如何持续部署node.js应用详解
最近在学习使用 travis-ci 对项目进行持续集成测试，所以下面这篇文章主要给大家介绍了关于使用travis-ci如何持续部署node.js应用的相关资料，文中介绍的非常详细，需要的朋友可以参考借鉴，下面来一起看看吧。
2017-07-07
node跨域请求方法小结
本篇文章主要介绍了node跨域请求方法小结，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-08-08
浅析Node.js非对称加密方法
本篇文章主要给大家分享了Node.js非对称加密方法以及代码实例讲解，对此有兴趣的朋友参考学习下吧。
2018-01-01
Node 模块原理与用法详解
这篇文章主要介绍了Node 模块原理与用法,结合实例形式详细分析了node.js模块基本概念、原理、用法及操作注意事项,需要的朋友可以参考下
2020-05-05
Node绑定全局TraceID的实现方法
这篇文章主要介绍了Node 绑定全局 TraceID的实现方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-11-11
PM2部署与管理Node.js项目的步骤
使用 PM2（Process Manager 2）来部署Node.js项目是一种非常流行的方法,因为它可以帮助你管理 Node.js 应用的进程,包括启动、停止、重启和监控,下面介绍如何使用PM2部署一个Node.js项目的步骤,感兴趣的朋友跟随小编一起看看吧
2025-10-10
利用forever和pm2部署node.js项目过程
这篇文章主要给大家介绍了如何利用forever和pm2部署node.js项目的相关资料，文中给出了详细的介绍和示例代码供大家参考学习，相信对大家的学习或者工作具有一定的学习价值，需要的朋友们下面随着小编一起来看看吧。
2017-05-05