https://before80.github.io/prgms/tools/brew/troubleshooting/Recent content in 8 故障排查 on 编程那些事儿Hugozh-cnThu, 10 Sep 2026 23:45:18 +0800https://before80.github.io/prgms/tools/brew/troubleshooting/8.1-troubleshooting-checklist/Wed, 09 Sep 2026 13:39:44 +0800https://before80.github.io/prgms/tools/brew/troubleshooting/8.1-troubleshooting-checklist/<blockquote> <p>原文链接: <a href="https://docs.brew.sh/Troubleshooting">https://docs.brew.sh/Troubleshooting</a></p> </blockquote> <h2 id="第一步更新并诊断">第一步：更新并诊断</h2> <p>在向任何人提问之前，先按顺序执行：</p> <div class="highlight"><div style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <pre tabindex="0" style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#58626f">1 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <pre tabindex="0" style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-sh" data-lang="sh"><span style="display:flex;"><span>brew update </span></span></code></pre></td></tr></table> </div> </div><p>再执行一次 <code>brew update</code>——第一次更新可能让失败命令仍停留在旧的 Homebrew 版本上。</p> <div class="highlight"><div style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <pre tabindex="0" style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#58626f">1 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <pre tabindex="0" style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-sh" data-lang="sh"><span style="display:flex;"><span>brew doctor </span></span></code></pre></td></tr></table> </div> </div><p>读完每一条警告，修复与失败命令相关的警告，然后<strong>重试原始命令并保存完整输出</strong>。</p>https://before80.github.io/prgms/tools/brew/troubleshooting/8.2-common-issues/Wed, 09 Sep 2026 13:39:44 +0800https://before80.github.io/prgms/tools/brew/troubleshooting/8.2-common-issues/<blockquote> <p>原文链接: <a href="https://docs.brew.sh/Common-Issues">https://docs.brew.sh/Common-Issues</a></p> </blockquote> <p>本页覆盖反复出现的 Homebrew 问题及当前推荐的非破坏性诊断步骤。<strong>先从 <a href="../8.1-troubleshooting-checklist/">8.1 排查清单</a> 开始，完整阅读错误信息，再修改文件或权限。</strong></p> <h2 id="缺少-command-line-tools">缺少 Command Line Tools</h2> <p>在 macOS 上从源码构建 formula 需要 Xcode Command Line Tools。反直觉的是：只安装完整 Xcode 并不够，CLT 是独立安装包：</p>https://before80.github.io/prgms/tools/brew/troubleshooting/8.3-cask-issues/Wed, 09 Sep 2026 13:39:44 +0800https://before80.github.io/prgms/tools/brew/troubleshooting/8.3-cask-issues/<blockquote> <p>原文链接: <a href="https://docs.brew.sh/Common-Issues">https://docs.brew.sh/Common-Issues</a></p> </blockquote> <h2 id="cask-下载失败">cask 下载失败</h2> <p>用下面的命令打开 cask 官网，并亲自测试厂商的下载链接：</p> <div class="highlight"><div style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <pre tabindex="0" style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#58626f">1 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <pre tabindex="0" style="color:#b0c4de;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-sh" data-lang="sh"><span style="display:flex;"><span>brew home &lt;cask&gt; </span></span></code></pre></td></tr></table> </div> </div><ul> <li>如果厂商下载本身也失败：向厂商报告，或检查网络连接；</li> <li>如果厂商发布了不同版本或 URL：提交 cask 更新。</li> </ul> <h2 id="cask-校验和不匹配">cask 校验和不匹配</h2> <p>仔细阅读错误，找到下载文件，<strong>只删除那一个缓存文件</strong>并重试一次：</p>