reference 速查表Homebrewbrew完整命令备忘 — 从安装到包管理、Cask、Tap 与清理【免费下载链接】reference面向开发者的技术速查清单Cheat Sheets集合整理常见技术、工具与开发流程帮助快速查阅关键信息提高开发效率。项目地址: https://gitcode.com/GitHub_Trending/referen/reference本文基于 reference 仓库中文开发者技术速查清单集合中的 Homebrew 备忘清单 docs/homebrew.md 系统整理覆盖 Homebrew 在 macOS或 Linux上的完整命令体系brew 本体的安装与国内镜像加速、软件包安装/卸载/链接、升级更新、Cask 图形应用管理、tap 第三方源仓库、缓存清理直至彻底卸载 Homebrew。读完后你可以直接按小节查阅每条brew子命令的用途并复制使用同时了解这张速查表在 reference 项目中如何被渲染与发布。速查表的定位与查看方式在 reference 项目中的位置Homebrew 被 docs/homebrew.md 原文开篇定义为macOS(或 Linux) 缺少的包管理器这张备忘清单整理brew命令的使用与安装。在 reference 仓库首页 README.md 中Homebrew 卡片归入软件包管理器分类与 APT、Yum、Pacman、Conan、CocoaPods、Cargo、SDKMAN 并列卡片链接指向./docs/homebrew.md并带有macOS标签见 README.md 软件包管理器分类。按照 docs/quickreference.md 的图标命名规范速查表文档homebrew.md对应首页图标 assets/homebrew.svg图标名称与清单名称保持一致SVG 使用1em尺寸与currentColor继承颜色见 图标规范说明。页面结构约定reference 仓库中每张速查表遵循统一结构见 页面结构约定一级标题H1作为页面大标题例如Homebrew 备忘清单大标题下紧跟一段介绍文本H2 作为分类标题安装、升级、Brew Cask 命令等H3 作为卡片卡片内容即命令表格或代码块。docs/homebrew.md 中还使用!--rehype:wrap-classrow-span-3--一类的 rehype 注释控制卡片网格的跨行布局如 安装章节的布局注释这些注释在渲染后不影响 Markdown 可读性。本地编译与在线查看reference 是纯静态速查站编译链路如下package.json 中定义了startrefs-cli --watch监听 md 文件实时生成 HTML与buildrefs-cli编译输出 HTML 到dist/脚本并要求 Node 16见 构建脚本本地调试流程npm i安装依赖、npm run build编译、用浏览器打开dist/index.html预览npm run start可开启监听模式见 本地编译预览部署侧netlify.toml 指定执行npm run build并发布dist目录Dockerfile 则把dist静态资源复制到精简的静态网站基础镜像中便于自建部署。因此本文整理的所有命令其原始出处均可在仓库的docs/homebrew.md中逐行对应。安装 Homebrew官方安装命令原文档给出的标准安装方式为下载并执行官方安装脚本见 安装命令/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)脚本引用自install/HEAD/install.shHEAD始终指向安装仓库的默认分支最新脚本适合常规安装场景。使用国内镜像加速安装和更新原文档提供的方法是把Homebrew/brew与Homebrew/homebrew-core两个仓库的 Git 镜像放到国内代码托管平台gitee同步后通过环境变量指向镜像地址再执行安装脚本见 镜像加速安装# 把 Homebrew/brew 的 Git 镜像放在这里 export HOMEBREW_BREW_GIT_REMOTE... # 将 Homebrew/homebrew-core 的 Git 镜像放在这里 export HOMEBREW_CORE_GIT_REMOTE... /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)两个变量的作用环境变量含义HOMEBREW_BREW_GIT_REMOTEHomebrew 主程序仓库brew 本体使用的 Git 镜像地址HOMEBREW_CORE_GIT_REMOTE核心配方仓库homebrew-core存放绝大多数 formula使用的 Git 镜像地址使用注意...占位符需替换为实际可用的镜像仓库 URL这两个环境变量应写入 shell 配置文件如~/.zshrc或~/.bashrc使其长期生效否则后续brew update、brew upgrade等涉及仓库拉取的操作仍会回落到官方仓库地址该方案的收益在于安装阶段以及之后的更新都走国内镜像拉取源码仓库的速度显著提升。安装期间跳过克隆beta原文档还给出了通过 API 模式安装、在安装期间跳过本地克隆的方式标注为 beta 特性见 API 模式安装export HOMEBREW_INSTALL_FROM_API1 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)设置HOMEBREW_INSTALL_FROM_API1后brew 通过 API 获取配方元数据而不在本地克隆庞大的 homebrew-core 仓库可以加快安装过程。安装、卸载与链接软件包原文档安装卸载一节的命令表见 安装卸载表完整如下命令说明brew install git安装一个软件包brew reinstall git重新安装一个软件包brew uninstall git删除/卸载软件包brew switch git 2.5.0切换软件包的版本brew unlink git取消软件包的链接brew link git链接已有的软件包brew cleanup git删除旧版本的软件包及依赖补充说明Homebrew 以配方formula描述软件包install会下载并构建配方、把可执行文件以符号链接方式挂到前缀目录prefix的bin下link/unlink就是手工控制这组符号链接例如同时安装多个版本时用来决定哪个版本的入口文件生效reinstall用于在同一版本上强制重新构建/重放安装过程适合修复安装损坏关于brew switch这是较早期 Homebrew 提供的版本切换子命令。在较新版本的 Homebrew 中该子命令已不再默认提供实际使用中若执行会提示命令不存在版本选择通常改为在brew install时结合配方参数如按 git tag 安装来实现具体以当前版本brew help的输出为准brew cleanup git针对单个配方清理旧版本后文清理一节会给出更完整的清理选项。升级与更新原文档升级一节的命令表见 升级表命令说明brew upgrade git升级一个软件包brew upgrade升级所有可升级的软件包brew update更新Homebrew和Caskupdate与upgrade的分工可以这样理解update刷新的是 Homebrew 自身及其配方仓库元数据相当于刷新软件源upgrade则是把已安装软件包升级到元数据中的最新可用版本。日常运维中可以先执行brew outdated见下文全局命令预览哪些包落后再决定是全部升级还是逐个升级。Brew Cask 命令管理图形界面应用原文档Brew Cask 命令一节见 Cask 表命令说明brew install --cask firefox安装火狐浏览器brew list --cask列出已安装应用Cask 命令用于与图形界面应用程序交互可以安装和管理 macOS 上的图形界面应用程序。Cask 是 Homebrew 面向.app图形应用浏览器、IDE、编辑器等的扩展命名空间普通brew install name安装的是命令行配方而brew install --cask name安装的则是带图形界面的应用包因此两者不会重名冲突。查看已安装的 Cask 应用时同样需要带上--cask标记如brew list --cask。更多包命令查看配方详情原文档更多包命令一节的命令表见 包命令表命令说明brew info git显示软件包的版本、依赖、注意事项等信息brew edit git编辑此软件包的安装脚本brew cat git打印此软件包的安装脚本brew home git打开此软件包的主页brew search git搜索软件包公式并显示相关信息brew list --versions git查看安装的软件包及其版本信息几点实操提示brew cat git输出配方内容即原文所称安装脚本通常为 Ruby 配方文件是了解一个包依赖了哪些库、如何构建的最直接方式brew edit git会调用编辑器打开该配方适合临时打补丁后配合brew install --build-from-source一类参数使用改动仅影响本机环境brew home git打开配方页面对应的项目主页便于追溯上游版本公告。全局命令原文档全局命令一节的命令表见 全局命令表命令说明brew list列出已安装的软件包brew outdated列出需要升级的软件包brew doctor诊断 Homebrew 是否存在问题brew pin formula防止指定软件包被升级brew unpin formula允许指定软件包被升级brew list不带参数时列出全部已安装配方配合--versions可以显示版本如brew list --versionsbrew pin/brew unpin是典型的版本锁定手段把依赖敏感的生产工具 pin 住后brew upgrade会跳过该配方待验证兼容后再unpin恢复升级brew doctor用于检查 Homebrew 安装与已装包的健康状态如依赖关系异常、未链接的包等常见问题环境出问题时建议优先执行。帮助命令原文档帮助命令一节见 帮助命令表命令说明brew help打印帮助信息brew help sub-command打印子命令的帮助信息遇到不确定的子命令参数时brew help sub-command是确认当前版本实际支持选项的可靠方式例如上文提到的brew switch是否存在直接brew help switch或执行该命令即可验证。Brew 清理旧版本与缓存管理原文档Brew 清理一节给出了六个清理场景见 清理章节删除旧版本的已安装软件包$ brew cleanup删除旧版本指定软件包$ brew cleanup formula清理并附带 scrub原文档简述为删除未安装的软件包$ brew cleanup -s删除所有 Homebrew 缓存$ brew cleanup --pruneall直接删除 Homebrew 的缓存目录$ rm -rf $(brew --cache)显示所有将被删除的软件包试运行$ brew cleanup -n各选项的作用说明不带参数的brew cleanup清理所有已安装配方的旧版本带配方名brew cleanup formula时只清理指定配方-ndry-run只打印将被删除的内容而不实际执行适合在清理前先确认影响范围--pruneall表示剪除全部下载缓存Homebrew 默认只会剪除超过默认时间窗口的缓存文件如需自定义窗口可用--pruneN形式的参数N 为小时数具体以brew help cleanup为准-s对应 Homebrew 的 scrub 行为即清理时同时移除 cellars 中的开发文件如头文件等原文档将其概括为删除未安装的软件包理解时以brew help cleanup对--scrub的说明为准brew --cache输出 Homebrew 缓存目录路径因此rm -rf $(brew --cache)是直接删除缓存目录的更暴力方式执行前建议先确认路径输出正确。Tap 管理第三方源码仓库原文档Brew 源码仓库一节见 Tap 章节整理如下原文中点击为 tap 的误译语义应为添加列出所有当前已添加的源码仓库tap$ brew tap使用 https 从 GitHub 中添加软件包源码仓库# https://github.com/user/homebrew-repo $ brew tap user/repo从指定 URL 中添加软件源码仓库$ brew tap user/repo URL从存储库中删除给定的源码仓库$ brew untap user/repoTap 机制的意义Homebrew 的配方分散在多个 Git 仓库中内置的homebrew-core覆盖了绝大多数软件当需要安装不在 core 中的软件如商业工具、小众组件时通过brew tap user/repo添加第三方配方仓库之后brew install就能从该 tap 找到配方不再需要时用brew untap移除。这与前文HOMEBREW_CORE_GIT_REMOTE的作用互补——后者只是给内置 core 仓库换镜像地址前者则是增删配方来源本身。搜索与查看原文档搜索查看一节见 搜索查看章节列出所有已安装的软件包$ brew list显示所有本地可用的 brew 配方$ brew search搜索包含指定字符的 brew 配方$ brew search text显示有关软件包的信息$ brew info formulabrew search不带参数时列出本地配方仓库中可用的全部配方数量庞大日常更常用带关键词的形式brew search text按关键词匹配配方名并支持正则表达式模式例如用正则同时匹配多个候选名。安装前先用brew info formula确认版本、依赖与注意事项是避免装完才发现依赖爆炸的好习惯。依赖关系查看原文档依赖一节见 依赖章节命令说明brew deps --tree --installed查看包和依赖关系图brew deps git显示 git 依赖brew deps用于显示包之间的依赖关系可针对单个配方brew deps git列出 git 依赖了哪些包加上--tree以树形结构呈现依赖层次--installed则把范围限定在已安装的包上。特定于某个包的其他选项可以附加到该命令具体以brew help deps为准。排查升级 A 为什么连带重装一堆库这类问题时该命令非常实用。卸载 Homebrew原文档卸载 Homebrew一节见 卸载章节给出两步使用官方卸载脚本卸载 Homebrew验证文件是否已删除。$ /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh) $ sudo rm -rf /opt/homebrew补充说明官方uninstall.sh会移除 brew 本体及其管理的安装内容第二条命令是对安装目录的兜底清理/opt/homebrew是 Apple Silicon Mac 上的默认前缀prefixIntel Mac 上默认前缀为/usr/local兜底删除前建议先用brew --prefix确认本机实际前缀路径卸载完成后按原文提示人工验证相关目录是否已删除ls检查前缀目录、which brew应无结果。高频命令速览将全篇最高频的命令收敛为一张速查表便于快速检索场景命令安装 / 重装 / 卸载包brew install f/brew reinstall f/brew uninstall f安装图形应用brew install --cask name升级 / 更新brew upgrade [f]/brew update查看已安装与版本brew list/brew list --versions查看可升级项brew outdated锁定 / 解锁版本brew pin f/brew unpin f查看配方详情brew info f/brew cat f/brew edit f搜索配方brew search [text]查看依赖brew deps [f]/brew deps --tree --installed清理旧版本 / 缓存brew cleanup/brew cleanup -n/brew cleanup --pruneall添加 / 移除第三方源brew tap user/repo/brew untap user/repo诊断brew doctor帮助brew help [sub-command]相关资源与延伸阅读Homebrew 的官方站点为 brew.shbrew 主程序仓库与 homebrew-core 配方仓库分别是Homebrew/brew与Homebrew/homebrew-core原文另见一节列出的外部资料本文按要求不输出外部链接本仓库软件包管理器分类下的兄弟速查表可横向对照APT、Yum、Pacman、Conan、CocoaPods、Cargo、SDKMAN速查表样式与构建规范见 docs/quickreference.md贡献流程见 CONTRIBUTING.md。【免费下载链接】reference面向开发者的技术速查清单Cheat Sheets集合整理常见技术、工具与开发流程帮助快速查阅关键信息提高开发效率。项目地址: https://gitcode.com/GitHub_Trending/referen/reference创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考