Homebrew 文档

故障排除

在创建问题之前，运行 brew update 两次，并运行 brew doctor（并修复所有警告）！

本文档将帮助你检查常见问题，并确保你的问题尚未被报告。

检查常见问题

• 仔细阅读 常见问题 列表。

检查该问题是否已报告

• 搜索相应的 issue 跟踪器，以查看是否有人已经报告了相同的问题
  • Homebrew/homebrew-core issue 跟踪器（公式）
  • Homebrew/homebrew-cask issue 跟踪器（木桶）
  • Homebrew/brew issue 跟踪器（brew 本身）
• 如果无法安装的公式或木桶属于非 Homebrew 抽头，请检查该抽头的 issue 跟踪器。
• 搜索 Homebrew 讨论论坛 或 Discourse 存档，以查看是否有人针对该问题发起了讨论。

创建问题

如果你的问题尚未解决或报告，请创建问题

1. 收集调试信息
   • 如果你在安装公式时遇到问题：运行 brew gist-logs <formula>（其中 <formula> 是公式的名称）将日志上传到新的 Gist。
   • 如果你遇到非公式问题：收集 brew config 和 brew doctor 的输出。
2. 在 Homebrew/homebrew-core、Homebrew/homebrew-cask 或 Homebrew/brew 的 issue 跟踪器上创建新问题，并按照说明进行操作
   • 为你的问题起一个描述性标题，其中包括公式名称（如果适用）以及你正在使用的 macOS 或 Linux 版本。例如，如果某个公式构建失败，请将你的问题标题命名为“<formula> 无法在 <platform> 上构建”，其中 <formula> 是无法构建的公式的名称，<platform> 是你正在使用的 macOS 或 Linux 的名称和版本。
   • 包括 brew gist-logs <formula> 提供的 URL（如果适用），以及你可能创建的任何其他 Gist 的链接。
   • 包括 brew config 和 brew doctor 的输出。