在 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 版本,可以使用 nnvm

使用 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 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • npm报错"A complete log of this run can be found in:"的解决办法

    npm报错"A complete log of this run can be found 

    这篇文章主要给大家介绍了关于npm报错"A complete log of this run can be found in:"的解决办法,文中通过实例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2023-04-04
  • NestJS系列核心概念之Module模块示例详解

    NestJS系列核心概念之Module模块示例详解

    这篇文章主要为大家介绍了NestJS系列核心概念之Module模块示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-09-09
  • node.js中的fs.close方法使用说明

    node.js中的fs.close方法使用说明

    这篇文章主要介绍了node.js中的fs.close方法使用说明,本文介绍了fs.close方法说明、语法、接收参数、使用实例和实现源码,需要的朋友可以参考下
    2014-12-12
  • Node爬虫工具Puppeteer入门教程实践

    Node爬虫工具Puppeteer入门教程实践

    Puppeteer是一个Node库,本文主要介绍了Node爬虫工具Puppeteer入门教程实践,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-05-05
  • node.js路径处理方法以及绝对路径详解

    node.js路径处理方法以及绝对路径详解

    这篇文章介绍的是nodejs路径处理及绝对路径以及一个Node.js获取项目根目录的小技巧,这个内容非常实用。有需要的朋友们可以参考借鉴,下面来一起看看吧。
    2016-09-09
  • 基于node简单实现RSA加解密的方法步骤

    基于node简单实现RSA加解密的方法步骤

    这篇文章主要介绍了基于node简单实现RSA加解密的方法步骤,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-03-03
  • 用node-webkit把web应用打包成桌面应用(windows环境)

    用node-webkit把web应用打包成桌面应用(windows环境)

    这篇文章主要介绍了windows环境下用node-webkit把web应用打包成桌面应用的教程,需要的朋友可以参考下
    2018-02-02
  • node vue项目开发之前后端分离实战记录

    node vue项目开发之前后端分离实战记录

    其实基于vue.js+node.js构建的开源博客系统有很多,下面这篇文章主要给大家介绍了关于node vue项目开发之前后端分离的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友下面来一起看看吧。
    2017-12-12
  • Node使用Sequlize连接Mysql报错:Access denied for user ‘xxx’@‘localhost’

    Node使用Sequlize连接Mysql报错:Access denied for user ‘xxx’@‘localh

    这篇文章主要给大家介绍了关于Node使用Sequlize连接Mysql报错:Access denied for user 'xxx'@'localhost'的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考借鉴,下面随着小编来一起学习学习吧。
    2018-01-01
  • 基于 Docker 开发 NodeJS 应用

    基于 Docker 开发 NodeJS 应用

    这是两篇文章的第一篇。本文涵盖了有关在使用 Express 框架开发一个Node应用时,用Docker 替代 Vagrant 的比较详细的教程, 应用将使用 connect-redis 中间件将会话信息持久化到Redis中. 第二篇文章将介绍到将这个开发的设置产品化.
    2014-07-07

最新评论