Homebrew 文件

疑難排解

在建立問題之前，請執行 brew update 兩次，並執行 brew doctor（並修正所有警告）！

本文件將協助您檢查常見問題，並確認您的問題尚未被回報。

檢查常見問題

• 閱讀 常見問題 清單。

檢查問題是否已回報

• 搜尋適當的問題追蹤器，查看是否有人已回報相同的問題
  • Homebrew/homebrew-core 問題追蹤器（公式）
  • Homebrew/homebrew-cask 問題追蹤器（桶裝軟體）
  • Homebrew/brew 問題追蹤器（brew 本身）
• 如果無法安裝的公式或桶裝軟體是屬於非 Homebrew 的 tap，請改為檢查該 tap 的問題追蹤器。
• 搜尋 Homebrew 討論論壇 或 Discourse 檔案，查看是否有任何關於此問題的討論串。

建立問題

如果您的問題尚未解決或回報，請建立一個問題

1. 收集除錯資訊
   • 如果您在安裝公式時遇到問題：請執行 brew gist-logs <formula>（其中 <formula> 是公式的名稱）將記錄上傳到新的 Gist。
   • 如果您遇到非公式的問題：請收集 brew config 和 brew doctor 的輸出。
2. 在 Homebrew/homebrew-core、Homebrew/homebrew-cask 或 Homebrew/brew 的問題追蹤器上建立新的問題，並遵循說明
   • 為您的問題提供一個具描述性的標題，其中包含公式名稱（如果適用）以及您所使用的 macOS 或 Linux 版本。例如，如果公式無法建置，請將您的問題標題命名為「<formula> 無法在 <platform> 上建置」，其中 <formula> 是無法建置的公式名稱，而 <platform> 是您所使用的 macOS 或 Linux 的名稱和版本。
   • 包含 brew gist-logs <formula> 所提供的 URL（如果適用），以及您可能已建立的任何其他 Gist 的連結。
   • 包含 brew config 和 brew doctor 的輸出。