![image](https://developer.qcloudimg.com/http-save/yehe-1209475/973f7d083c31d25c21ddc9068316afc2.png)

## 前言

你好，我是喵喵侠，是一名前端开发。

今天我想给电脑装一款清理垃圾的开源小工具 `mole`，本来以为就是一行命令的事儿，结果 Homebrew 直接给我甩了个报错，提示我的命令行工具（CLT）版本不对。

我现在用的系统是 macOS 26.2，看到报错里有 `sudo rm -rf` 这种删库命令，我第一反应也是心里一紧，生怕手抖删错了系统文件。不过查了查资料，其实问题不大，就是系统升级后残留的开发工具包版本不匹配了。下面记录下我的踩坑和解决过程。

## 案发现场

我执行的安装命令是：

```bash
brew install tw93/tap/mole
```

结果终端直接吐出了这么一大段报错：

```text
➜ brew install tw93/tap/mole
==> Tapping tw93/tap
Cloning into '/usr/local/Homebrew/Library/Taps/tw93/homebrew-tap'...
...
==> Installing mole from tw93/tap
Error: Your Command Line Tools (CLT) does not support macOS 26.
It is either outdated or was modified.
Please update your Command Line Tools (CLT) or delete it if no updates are available.
Update them from Software Update in System Settings.

If that doesn't show you any updates, run:
  sudo rm -rf /Library/Developer/CommandLineTools
  sudo xcode-select --install

Alternatively, manually download them from:
  https://developer.apple.com/download/all/.
You should download the Command Line Tools for Xcode 26.0.
```

简单翻译一下，就是 Homebrew 检测到我当前的 Command Line Tools (CLT) 版本不支持 macOS 26，建议我更新或者重装。

## 解决方案

虽然报错提示里给出了几种方案，我们可以按照从易到难的顺序来尝试。

### 方法一：系统更新

我们先检查一下系统是否有推送相关的更新。打开 ​**系统设置 (System Settings)** ​，找到 **通用 (General)**  -\> ​**软件更新 (Software Update)** 。

看看列表里有没有叫 `Command Line Tools for Xcode` 的更新项。如果有，直接点安装，装完重启终端基本就好了。如果没有，那说明需要手动干预，我们尝试方法二。

### 方法二：命令行重装（推荐）

这是我这次使用的方法，也是报错信息里明确指引的操作。

#### 1. 删除旧版工具

打开终端，输入下面这条命令。注意这需要管理员权限，输入密码时屏幕上不会显示星号，输完回车就行。

```bash
sudo rm -rf /Library/Developer/CommandLineTools
```

这一步是为了删除当前版本不匹配的 Command Line Tools 文件夹。

#### 2. 触发重装

删除完成后，执行以下命令来触发系统的安装引导：

```bash
sudo xcode-select --install
```

输入完这个命令后，系统会弹出一个安装确认窗口。点击“安装”，然后同意协议，接下来等待下载完成 Command Line Tools 即可。

![PixPin_2025-12-16_22-28-01](https://developer.qcloudimg.com/http-save/yehe-1209475/b2bb9e94c7fa57f691cc3a3693dc3140.jpg "xcode-select安装提示")

![PixPin_2025-12-16_22-28-34](https://developer.qcloudimg.com/http-save/yehe-1209475/464e4af7e9911008dc096b5b48536cf8.jpg "许可协议")

下载速度取决于你的网速，可能会有点慢，耐心等待。

![PixPin_2025-12-16_22-40-04](https://developer.qcloudimg.com/http-save/yehe-1209475/b8a927c15afde5a4c4b5e44d1962c407.jpg "安装完成")

### 方法三：手动下载

如果上面那招不好使（比如网络一直下载失败），那就只能去苹果官网手动下载了。

#### 1. 访问开发者网站

点击下面这个链接，登录你的 Apple ID（没有的话注册一个，免费的）：  
[https://developer.apple.com/download/all/](https://www.google.com/url?q=https%3A%2F%2Fdeveloper.apple.com%2Fdownload%2Fall%2F "https://developer.apple.com/download/all/")

#### 2. 搜索下载

在页面左上角的搜索框里输入 `Command Line Tools for Xcode`​。找到对应版本（报错里提示是 Xcode 26.0，我们就下载这个版本），下载 `.dmg` 文件后双击安装。

## 验证与重试

操作完成后，我们需要确认一下环境是否修复成功。

#### 检查路径

在终端输入：

```bash
xcode-select -p
```

如果输出类似 `/Library/Developer/CommandLineTools`​ 或者 `/Applications/Xcode.app/Contents/Developer` 这样的路径，说明 CLT 已经安装就位。

#### 重新安装软件

这时候，我再次执行最初的安装命令：

```bash
brew install tw93/tap/mole
```

这次没有报错了，顺利安装完成。

## 总结

其实这种问题在 macOS 刚升级大版本或者 Xcode 更新后特别容易出现。核心原因就是 Homebrew 依赖的编译环境和系统实际的工具链版本不一致。

以后遇到这种 `CLT outdated` 的报错，按照上面的步骤删了旧目录重装通常就能解决。

今天我想给电脑装一款清理垃圾的开源小工具 mole，本来以为就是一行命令的事儿，结果 Homebrew 直接给我甩了个报错，提示我的命令行工具（CLT）版本不对。

macOS 下 brew 安装报错：Your Command Line Tools (CLT) does not support macOS 26 解决办法

前端

MacOS系统升级后CommandLineTools版本不匹配导致Homebrew安装失败？教你3种解决方案：通过系统更新、命令行重装或官网手动下载CLT工具包。删除旧版本后执行xcode-select --install即可修复，确保开发环境正常运行。

命令行工具

Xcode

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

macOS 下 brew 安装报错：Your Command Line Tools (CLT) does not support macOS 26 解决办法-腾讯云开发者社区-腾讯云

macOS 下 brew 安装报错：Your Command Line Tools (CLT) does not support macOS 26 解决办法

macOS 下 brew 安装报错：Your Command Line Tools (CLT) does not support macOS 26 解决办法

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐