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

macOS 下通过 Homebrew 安装 Node.js 指南

在 macOS 系统下利用 Homebrew 包管理器安装 Node.js 的全过程。涵盖环境准备、安装稳定版或特定版本、验证安装结果、配置环境变量、升级与卸载操作。此外还提供了使用 n 和 nvm 工具管理多版本 Node.js 的方案,并列举了版本不匹配、命令未找到及权限问题等常见故障的解决方法。

静心发布于 2026/3/24更新于 2026/7/248K 浏览

macOS 下通过 Homebrew 安装 Node.js 指南

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 install 14
nvm use 14
# 然后按照提示配置环境变量
# 使用 nvm 安装和管理版本

7. 卸载 Node.js

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

常见问题解决

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

brew postinstall node

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

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

权限问题:如果遇到权限错误,可以尝试:

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

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

目录

  1. macOS 下通过 Homebrew 安装 Node.js 指南
  2. 1. 准备工作
  3. 检查是否已安装 Homebrew
  4. 如果未安装,使用以下命令安装
  5. 2. 安装 Node.js
  6. 方法一:安装最新稳定版(推荐)
  7. 方法二:安装特定版本
  8. 先搜索可用的 Node.js 版本
  9. 安装特定版本(如 18.x)
  10. 3. 安装后的验证
  11. 检查 Node.js 版本
  12. 检查 npm 版本
  13. 检查 npx 版本
  14. 4. 环境变量配置(仅当安装特定版本时需要)
  15. 对于 bash/zsh 用户
  16. 然后重新加载配置文件
  17. 5. 升级 Node.js
  18. 先更新 Homebrew
  19. 然后升级 Node.js
  20. 6. 切换 Node.js 版本(可选)
  21. 使用 n 管理版本
  22. 安装 n
  23. 安装特定版本
  24. 切换版本
  25. 使用 nvm 管理版本
  26. 安装 nvm
  27. 然后按照提示配置环境变量
  28. 使用 nvm 安装和管理版本
  29. 7. 卸载 Node.js
  30. 卸载 Node.js
  31. 如果需要彻底删除残留文件
  32. 常见问题解决
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • LLaMA-Factory 微调至高通 NPU 部署:Qwen-0.6B 全链路移植指南
  • GitHub 私有仓库转为公共仓库的操作步骤
  • 安装 Microsoft Visual C++ Build Tools 配置指南
  • Java IO 流:从文件操作到网络通信
  • Mac mini 安装配置 OpenClaw 指南
  • WebStorm 安装与首次配置指南
  • 基于大语言模型的生成式文本隐写研究(MM'24)
  • OpenMAIC:清华团队开源的 AI 课堂生成工具
  • FAIR plus 机器人全产业链接会:聚焦具身智能与产业链协同
  • Python 环境安装与配置 Gurobi 求解器指南
  • C++ 基础语法完全入门指南
  • Java 充电桩平台故障排查优化:日志分级存储与链路关联方案
  • JSP 数据库备份功能源码示例
  • Boston Dynamics(波士顿动力)机器人进化史
  • OpenClaw 配置与 QQ Bot 接入指南
  • 文心一言 4.5 开源深度解析:轻量化部署与中文场景优化
  • Python 拒绝采样算法优化与多峰分布模拟实战
  • Mac Mini M4 本地 AI 模型部署指南:从 Ollama 到 Stable Diffusion 配置
  • GitHub 生成 SSH 密钥配置指南
  • 基于 Vue3+TS+Three.js 的 VR 全景看房应用实战

相关免费在线工具

  • 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