如何安装MacThrottle?Homebrew一键、DMG下载、Xcode本地构建3种方式完整教程
如何安装MacThrottle?Homebrew一键、DMG下载、Xcode本地构建3种方式完整教程
MacThrottle 是一款轻量级的 macOS 菜单栏应用,专门用来监控 Mac 的热节流(Thermal Throttling)状态:当芯片过热降频时,它会通过菜单栏温度计图标和通知提醒你。无需管理员权限、不依赖辅助守护进程。本文提供 Homebrew 一键安装、DMG 下载、Xcode 本地构建 3 种完整安装方式,几分钟即可让 Mac 散热状态一目了然。🌡️
上图即安装成功后的实际效果:左侧是应用主窗口,右侧是菜单栏面板,可看到 Thermal Pressure 状态、CPU 温度、最近 10 分钟历史曲线和各状态耗时统计。
安装前准备:系统要求检查
安装 MacThrottle 前,请先确认环境满足要求(详见 README.md):
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS 15.0+(Sequoia) |
| 权限 | 无需管理员权限 |
| 开发工具 | 仅 Xcode 本地构建方式需要 |
确认方式:点击左上角 → 关于本机,查看 macOS 版本即可。
方式一:Homebrew 一键安装(推荐)
如果你已安装 Homebrew,这是最快的方式——两条命令搞定:
brew tap angristan/tap
brew install --cask macthrottle
安装完成后,应用会自动出现在你的应用程序中。首次启动后,菜单栏会出现一个温度计图标,点击即可查看实时散热状态。
✅ 优点:一条命令完成,后续还可用 brew upgrade macthrottle 直接升级。
方式二:DMG 下载手动安装
适合不想使用 Homebrew 的用户。步骤如下:
- 进入项目的 Releases 页面,下载最新的
.dmg安装包; - 打开
.dmg,将MacThrottle.app拖入Applications(应用程序)文件夹; - 由于应用未做代码签名,首次启动时 Gatekeeper 可能会拦截。打开终端执行以下命令移除隔离属性:
xattr -r -d com.apple.quarantine /Applications/MacThrottle.app
- 重新打开应用即可正常使用。
⚠️ 提示:如果命令执行后仍被拦截,可直接右键应用图标选择"打开",或在 系统设置 → 隐私与安全性 中点击"仍要打开"。
方式三:Xcode 本地构建(自动签名,彻底避开 Gatekeeper)
本地构建会自动使用你的开发证书签名,从根本上避免 Gatekeeper 拦截问题,适合有 Xcode 环境的用户。
第 1 步:克隆源码
git clone https://gitcode.com/gh_mirrors/mac/MacThrottle
cd MacThrottle
第 2 步:命令行构建并运行
xcodebuild -project MacThrottle.xcodeproj \
-scheme MacThrottle \
-configuration Release \
-derivedDataPath build
open build/Build/Products/Release/MacThrottle.app
更简单的替代方案 🛠️:直接用 Xcode 打开 MacThrottle.xcodeproj,按下 Cmd + R 即可构建并运行(Debug 模式)。
开发者加分项:仓库自带 Makefile,一条命令完成"构建 → 关闭旧进程 → 启动"的完整开发流程:
make dev
此外,仓库的 scripts/set-version.sh 脚本可以一键更新版本号,方便二次开发。
三种安装方式怎么选?
| 安装方式 | 难度 | 适合人群 | 签名问题 |
|---|---|---|---|
| Homebrew | ⭐ 最简单 | 绝大多数用户(推荐) | 同 DMG 版 |
| DMG 下载 | ⭐⭐ 简单 | 不想装 Homebrew 的用户 | 需手动移除隔离属性 |
| Xcode 构建 | ⭐⭐⭐ 中等 | 开发者、想彻底避开 Gatekeeper 的用户 | 自动本地签名 |
安装验证:30 秒确认一切正常
安装完成后,按以下清单快速验证:
- ✅ 菜单栏出现温度计图标:图标随状态变化——
Nominal(正常)、Moderate(偏高)、Heavy(正在降频)、Critical(严重降频); - ✅ 温度与风扇数据:面板中显示 CPU 最高核心温度(直接读取 SMC 传感器)和风扇转速百分比。无风扇机型(如 MacBook Air)不显示风扇数据,属正常现象;
- ✅ 历史曲线与统计:可查看最近 10 分钟的热压力/温度/风扇曲线,以及各状态累计时长(相关界面实现见 MacThrottle/Views/MenuContentView.swift);
- ✅ 通知设置:可在面板中开启 Heavy / Critical 降频提醒、恢复提醒和提示音。
温度读取逻辑(SMC 为主、IOHIDEventSystem 兜底)可在 MacThrottle/Services/TemperatureReaders.swift 中查看,热压力监控核心在 MacThrottle/Services/ThermalMonitor.swift。
常见问题 FAQ
Q1:为什么不用 ProcessInfo.thermalState 公共 API?
macOS 公共 API 只区分 4 个状态,而系统实际有 5 级热压力——moderate 和 heavy 都被归为 fair,但 heavy 才是真正开始降频的临界点。MacThrottle 通过 Darwin 通知机制(com.apple.system.thermalpressurelevel)直接读取 5 级状态,粒度更精准。
Q2:菜单栏图标不见了?
打开"系统设置 → 控制中心",确认菜单栏没有隐藏该应用;或直接从启动台重新运行 MacThrottle.app。还可以开启面板中的 Launch at Login 选项,让应用开机自启(实现见 MacThrottle/Services/LaunchAtLoginManager.swift)。
Q3:构建时报错找不到 scheme?
请确认在仓库根目录下执行 xcodebuild,并使用 -project MacThrottle.xcodeproj -scheme MacThrottle 参数(scheme 配置见 MacThrottle.xcodeproj/xcshareddata/xcschemes/MacThrottle.xcscheme)。
三种方式任选其一,MacThrottle 就会安静地驻留在菜单栏,在你 Mac 过热降频前给出提示——装好之后,跑渲染、编译大项目时再也不会"莫名变卡"了。💪
