如何安装MacThrottle?Homebrew一键、DMG下载、Xcode本地构建3种方式完整教程

原创2026-10-30 18:38:331,036 阅读

如何安装MacThrottle?Homebrew一键、DMG下载、Xcode本地构建3种方式完整教程

MacThrottle 是一款轻量级的 macOS 菜单栏应用,专门用来监控 Mac 的热节流(Thermal Throttling)状态:当芯片过热降频时,它会通过菜单栏温度计图标和通知提醒你。无需管理员权限、不依赖辅助守护进程。本文提供 Homebrew 一键安装、DMG 下载、Xcode 本地构建 3 种完整安装方式,几分钟即可让 Mac 散热状态一目了然。🌡️

MacThrottle macOS热节流监控菜单栏应用截图,展示温度曲线、Thermal Pressure状态与统计面板

上图即安装成功后的实际效果:左侧是应用主窗口,右侧是菜单栏面板,可看到 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 的用户。步骤如下:

  1. 进入项目的 Releases 页面,下载最新的 .dmg 安装包;
  2. 打开 .dmg,将 MacThrottle.app 拖入 Applications(应用程序)文件夹;
  3. 由于应用未做代码签名,首次启动时 Gatekeeper 可能会拦截。打开终端执行以下命令移除隔离属性:
xattr -r -d com.apple.quarantine /Applications/MacThrottle.app
  1. 重新打开应用即可正常使用。

⚠️ 提示:如果命令执行后仍被拦截,可直接右键应用图标选择"打开",或在 系统设置 → 隐私与安全性 中点击"仍要打开"。

方式三: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 过热降频前给出提示——装好之后,跑渲染、编译大项目时再也不会"莫名变卡"了。💪

登录后查看全文
MacThrottle