跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

Mac 平台 Homebrew 安装配置及常用命令详解

Mac 系统 Homebrew 是管理命令行工具的软件包管理器。介绍其基本概念、常规安装步骤及国内镜像加速方案,解决网络卡顿问题。涵盖 Intel 与 Apple 芯片系统的版本要求、终端操作、环境变量配置以及常用命令如 install、upgrade、uninstall。同时提供权限错误处理及卸载方法,帮助开发者高效管理 Mac 开发环境。

城市逃兵发布于 2026/3/16更新于 2026/9/1188 浏览

一、先搞懂:Homebrew 到底是啥?有啥用?

简单说,Homebrew 是 Mac 上的 '软件管家',就像手机里的应用商店(比如苹果 App Store、华为应用市场)。但它比普通应用商店更强大:

  • 能装 App Store 里没有的软件(比如命令行工具 wget、视频处理工具 ffmpeg);
  • 安装、更新、卸载软件都靠 '一行命令',不用手动找安装包、点下一步;
  • 自动帮你处理软件的依赖(比如 A 软件需要 B 工具才能运行,brew 会自动装 B)。

对开发者来说,学会用 brew,以后装软件再也不用到处搜 "Mac 版 XXX 下载",也不怕下到病毒或旧版本了。

二、准备工作:安装前要确认这 2 件事

在装 brew 前,先检查一下你的 Mac 是否符合条件,避免白忙活:

  1. 确认 Mac 系统版本
  • Intel 芯片 Mac:需要 macOS 10.13(High Sierra)及以上(大部分 2017 年后的 Mac 都满足);
  • Apple 芯片 Mac(比如 M1/M2/M3):需要 macOS 11(Big Sur)及以上(2020 年后的 Mac 基本都符合)。怎么看系统版本?点击屏幕左上角苹果图标 → 关于本机,就能看到 "macOS 版本"。
  1. 打开 '终端'(Terminal)

终端是 Mac 上的 '命令行工具',我们要在这儿输入命令装 brew。打开方法有 2 种,小白推荐第 1 种:

  • 方法 1:按下键盘 Cmd + 空格(调出 Spotlight 搜索),输入 "Terminal",按回车(出现黑色窗口就是终端);
  • 方法 2:打开 '启动台' → '其他' 文件夹 → 双击 '终端'。

三、常规安装:3 步搞定 brew(适合网络好的情况)

如果你的网络能顺畅访问国外网站(比如 GitHub),按下面步骤来,5 分钟就能装完:

第 1 步:复制安装命令到终端

打开终端后,复制下面这行命令(全选后按 Cmd + C),然后粘贴到终端里(按 Cmd + V):

/bin/bash -c "\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

粘贴后按回车,终端就会开始下载 brew 的安装脚本。

第 2 步:按提示输入密码、同意安装
  • 提示 "Password"(密码):输入你 Mac 的开机密码(输入时屏幕上不会显示字符,别以为没输进去,输完直接按回车就行);
  • 提示 "Press RETURN to continue or any other key to abort"(按回车继续,按其他键取消):直接按回车;
  • 提示安装 "Xcode Command Line Tools":这是苹果的开发工具包,brew 需要它才能运行,终端会自动下载安装,你等着就行(可能要等几分钟,别关掉终端)。
第 3 步:验证是否安装成功

等终端显示 "Installation successful!"(安装成功)后,输入下面这行命令,按回车:

brew --version

如果出现类似 "Homebrew 4.2.18" 的文字,说明 brew 装好了!如果提示 "command not found"(命令找不到),别慌,先看后面的 "卡顿解决办法"。

四、重点!安装时卡住 / 失败?3 个办法解决

很多小白会遇到 "复制命令后,终端一直转圈 / 停在某个地方不动",这 90% 是因为网络问题(brew 的默认资源在国外,国内访问慢)。试试下面 3 个办法,按顺序来,基本都能解决:

办法 1:先检查网络,切换热点(最简单)
  • 首先确认你的 Wi-Fi 能正常上网(比如打开浏览器登百度);
  • 如果用的是公司 / 校园 Wi-Fi,可能有防火墙限制,试试切换手机热点(把手机 5G/4G 开热点,Mac 连手机热点),再重新运行安装命令;
  • 如果热点也不行,别急,用办法 2(国内镜像,推荐小白用)。
  • 办法 2:用国内镜像安装(最快最稳,小白首选)

    国内的科技公司(比如中科大、清华)把 brew 的资源搬到了国内服务器,用这些 "镜像" 安装,速度会快 10 倍以上。操作步骤:

    1. 打开终端,复制下面这行命令,按回车:
    /bin/bash -c "\$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
    
    1. 选择镜像源:终端会列出几个选项(比如 "1. 中科大镜像源" "2. 清华镜像源"),输入数字(比如输 1),按回车;
    2. 确认安装:提示 "是否继续安装",输入 "y"(表示 yes),按回车;
    3. 后续步骤和 "常规安装" 一样:输入开机密码、等待安装,直到出现 "安装成功"。

    这个办法几乎不会卡住,因为用的是国内服务器,小白强烈推荐!

    办法 3:手动下载脚本,避免 curl 命令卡住

    如果连 "国内镜像命令" 都卡住,可能是 curl 工具(终端用来下载文件的工具)有问题,试试手动下载安装脚本:

    1. 打开浏览器,复制这个链接并访问:https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
    2. 页面加载后,全选所有文字(按 Cmd + A),复制(Cmd + C);
    3. 打开 "文本编辑"(启动台 → 其他 → 文本编辑),粘贴刚才复制的内容,然后按 Cmd + S 保存,文件名填 "brew_install.sh",保存位置选 "桌面"(方便找);
    4. 回到终端,输入下面这行命令(作用是进入桌面文件夹),按回车:
    cd ~/Desktop
    
    1. 再输入下面这行命令(运行刚才保存的脚本),按回车:
    /bin/bash brew_install.sh
    
    1. 之后按提示输入密码、等待安装即可。

    五、安装成功后:小白必学的 3 个基础命令

    装完 brew 不是结束,学会用它装软件才是关键!记住下面 3 个命令,够用 90% 的场景:

    1. 装软件:brew install 软件名

    比如想装 "压缩工具 keka",终端输入:

    brew install keka
    

    想装 "命令行工具 wget",输入:

    brew install wget
    

    输入后按回车,brew 会自动下载安装,不用管,等提示 "Successfully installed" 就装好了。

    2. 更新软件:brew upgrade 软件名

    比如想更新 keka 到最新版,输入:

    brew upgrade keka
    

    如果想更新所有用 brew 装的软件,输入:

    brew upgrade
    
    3. 卸载软件:brew uninstall 软件名

    比如想删掉 wget,输入:

    brew uninstall wget
    

    六、常见问题:小白遇到这些情况别慌

    1. 终端提示 "Permission denied"(权限不够)?大概率是输入密码时输错了,重新运行命令,仔细输开机密码(输的时候不显示字符,正常)。
    2. Apple 芯片 Mac 装完后,用 brew 命令提示 "command not found"?因为 Apple 芯片的 Mac,brew 默认安装路径变了,需要先输入下面这行命令(配置环境变量),按回车,之后再用 brew 命令就行:
    echo 'eval "\$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
    source ~/.zprofile
    
    1. 想彻底卸载 brew,怎么操作?打开终端,输入下面这行命令,按回车,按提示操作即可:
    /bin/bash -c "\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
    

    总结

    对 Mac 用户来说,brew 是提升效率的 "神器",安装时遇到卡顿不用怕,优先试试 "国内镜像安装"(办法 2),基本都能解决。记住 "装软件用 install、更新用 upgrade、卸载用 uninstall",以后装软件再也不用愁啦!

    目录

    1. 一、先搞懂:Homebrew 到底是啥?有啥用?
    2. 二、准备工作:安装前要确认这 2 件事
    3. 三、常规安装:3 步搞定 brew(适合网络好的情况)
    4. 第 1 步:复制安装命令到终端
    5. 第 2 步:按提示输入密码、同意安装
    6. 第 3 步:验证是否安装成功
    7. 四、重点!安装时卡住 / 失败?3 个办法解决
    8. 办法 1:先检查网络,切换热点(最简单)
    9. 办法 2:用国内镜像安装(最快最稳,小白首选)
    10. 办法 3:手动下载脚本,避免 curl 命令卡住
    11. 五、安装成功后:小白必学的 3 个基础命令
    12. 1. 装软件:brew install 软件名
    13. 2. 更新软件:brew upgrade 软件名
    14. 3. 卸载软件:brew uninstall 软件名
    15. 六、常见问题:小白遇到这些情况别慌
    16. 总结

    更多推荐文章

    查看全部
    • WebStorm 下载与安装配置指南
    • LeetCode 380 O(1) 时间插入、删除和获取随机元素
    • Android 应用视觉优化:10 个 UI 技巧
    • Java 阻塞队列原理及生产者 - 消费者模型应用
    • 2024 年 AI 视频生成项目盘点:102 个精选
    • WSL 2 Ubuntu 22.04 安装及 D 盘迁移配置指南
    • 基于 Python 的商品销售数据分析与可视化实战
    • LLM 微调系列:LoRA 技术综述与优化策略
    • 基于麻雀搜索算法的 LSSVM 回归预测参数优化
    • Visual Studio 关闭 Copilot AI 代码提示的方法
    • Xilinx FPGA 外部 SPI Flash 启动时钟频率配置
    • 谷歌 Gemini 3 模型六种免费接入与使用方案
    • Dify MCP Server 插件实战:将工作流发布为第三方服务
    • 基于 OpenClaw 搭建飞书 AI 办公机器人:本地模型接入与技能自动化
    • Java 中使用 Lua 脚本实现 Redis 原子操作与高并发场景优化
    • Stable Diffusion 秋叶整合包部署与实战指南
    • FPGA 设计核心概念:扇出(Fan-out)详解与优化
    • 无人机电机与电子调速器模块详解
    • Lada v0.10.1 本地 AI 视频去马赛克工具使用指南
    • 修改 WSL2 网络模式为 Mirrored 以使用 Windows 代理

    相关免费在线工具

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

    • Markdown转HTML

      将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

    • HTML转Markdown

      将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

    • JSON 压缩

      通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

    • JSON美化和格式化

      将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online