BlackHole 虚拟音频环回驱动排障指南：设备不显示、无声、卡顿、装不上怎么办

BlackHole 虚拟音频环回驱动排障指南设备不显示、无声、卡顿、装不上怎么办【免费下载链接】BlackHoleBlackHole is a modern macOS audio loopback driver that allows applications to pass audio to other applications with zero additional latency.项目地址: https://gitcode.com/gh_mirrors/bl/BlackHoleBlackHole 是 macOS 上的虚拟音频环回驱动让应用之间零延迟互传音频。本文用「自检 → 定位 → 修复」三步带你逐一处理设备不显示、无声、卡顿断流与安装失败这四类常见故障。 原理速览BlackHole 不是普通 App而是一个注入系统的 Core Audio 音频单元HAL 驱动。安装后它会在系统里注册一块「虚拟声卡」任何应用都可以把它选成输出或输入设备从而实现「应用 A 的声音 → BlackHole → 应用 B」。官方提供 2、16、64、128、256 声道多个版本原理相同差别只是同时能路由的通道数。它兼容 macOS 10.10 及以上、同时支持 Intel 与 Apple Silicon且无需内核扩展、不改动系统安全机制适合直播连线、在线会议、系统声音录音和 DAW 对接等场景。✅ 30 秒自检清单动手深入排障前先用这张表把问题范围缩小现象快速检查项如何判定设备列表里找不到 BlackHole打开「音频 MIDI 设置」看设备列表确认/Library/Audio/Plug-Ins/HAL/BlackHoleXch.driver存在X 为声道数如2、16、64驱动包在、设备不显示 → 在终端执行sudo killall -9 coreaudiod重载音频服务安装卡住、走不完流程检查.pkg安装包放在哪个文件夹在「下载」里就挪到「桌面」重新打开或反过来部分 macOS 版本存在该已知怪癖选定了 BlackHole 却完全无声查看 DAW 的麦克风权限查看「音频 MIDI 设置」中的输入/输出音量权限未勾选或音量没拉满先修这两处听了几分钟后卡顿、断流检查聚合/多输出设备的时钟与漂移设置非时钟源设备未勾选「漂移校正」是断流的最常见原因 高频问题逐个击破BlackHole「消失」了它本来就不在应用程序文件夹原因多数人找不到设备是因为找错了地方。BlackHole 是虚拟驱动不会在「应用程序」文件夹里留下任何图标它只出现在「音频 MIDI 设置」「声音」偏好设置以及其他音频应用的下拉列表里。解决步骤打开「音频 MIDI 设置」或系统偏好设置 → 声音确认设备列表中有BlackHole 2ch或你安装的对应声道版本若列表中没有打开终端确认驱动包是否落位路径应为/Library/Audio/Plug-Ins/HAL/BlackHoleXch.driverX 换成实际声道数文件在、设备却不显示时强制刷新音频服务终端输入sudo killall -9 coreaudiod系统会自动重启该进程并重新扫描驱动安装包卡住、装不完成原因部分 macOS 版本存在已知问题——.pkg安装包位于某些特定文件夹时无法正常完成安装。解决步骤若.pkg下载到「下载」文件夹把它移到「桌面」再双击打开原本在桌面的则反过来试安装前先关闭所有正在运行的音频应用避免设备被占用仍异常时用对应声道数的官方卸载器2ch/16ch/64ch清理干净再重来仓库内 Uninstaller/ 目录的 create_uninstaller.sh 展示了卸载器如何构建也可以手动卸载删除/Library/Audio/Plug-Ins/HAL/BlackHoleXch.driver目录注意是系统根目录的/Library不是用户主目录下的~/Library再执行sudo killall -9 coreaudiod让变更生效重新安装时更推荐 Homebrewbrew install blackhole-2ch、blackhole-16ch或blackhole-64ch设备选好了却一点声音都没有原因三个高频元凶——DAW 没有麦克风权限BlackHole 的输入在系统眼中等同于「麦克风」、BlackHole 内部输入/输出音量没拉满、多输出配置下内置输出不在设备列表顶部。解决步骤打开「系统偏好设置」→「安全性与隐私」→「隐私」→「麦克风」确认你的 DAW 已被勾选打开「音频 MIDI 设置」把 BlackHole 的输入和输出音量滑块都拉到最大正在使用多输出设备的话macOS 要求内置输出Built-in Output必须处于启用状态并排在设备列表最顶部否则部分应用会完全不出声听了几分钟后卡顿、断流原因聚合设备或多输出设备里各设备晶振之间存在细微频差。不开漂移校正误差会随运行时间累积最终表现为爆音、断流。另一个隐蔽原因是应用本身不兼容Apple Podcasts、Apple Messages信息、HDHomeRun 均已确认与多输出设备不兼容。解决步骤在「音频 MIDI 设置」中打开聚合/多输出设备为除时钟源主设备外的所有设备勾选「漂移校正」时钟源要选稳定的 2 声道设备内置输出或 BlackHole 2ch 都可以BlackHole 16ch 不能当主设备因为主设备必须是 2 声道涉及 AirPods 时注意它的麦克风工作在更低采样率上切勿用它当主/时钟设备改用内置扬声器静音即可或 BlackHole 2ch 担任时钟源设置无误仍断续的话先换 2ch 版本复测排除应用对高声道数的兼容性问题️ 进阶配置与调优采样率BlackHole 支持 8kHz 到 768kHz 共 12 档8、16、44.1、48、88.2、96、176.4、192、352.8、384、705.6、768 kHz。请确保发送端与接收端应用使用同一采样率否则会出现音高偏移或杂音。位深固定为 32-bit float——这是 macOS Core Audio 的系统级原生格式兼容性最好无需在驱动层面调整。聚合设备主从配置主设备时钟源决定整组设备的节奏选低延迟、稳定的 2 声道设备其余设备全部开启漂移校正调完后放一段长音频循环播放观察是否仍有断点。音量控制系统音量条无法调节多输出设备这是 macOS 的限制只能在「音频 MIDI 设置」里逐个拉各成员设备的音量。经验值主音量设为 1.0对应 6.0 dB不衰减也不放大。若想整体调整多输出设备的增益可借助 MultiSoundChanger 这类第三方小工具。版本选择日常场景 2ch 足够16ch 及以上面向多通道制作与复杂路由。声道数越高对 CPU 压力越大搭配高采样率时更易断续README 的开发者指南也专门提醒了这一点。给进阶用户需要自定义设备名、声道数、延迟或采样率时可借助kNumber_Of_Channels、kLatency_Frame_Size、kSampleRates等预处理常量通过xcodebuild的GCC_PREPROCESSOR_DEFINITIONS注入编译kDevice2_*系列常量还能创建镜像设备做出一路纯输入、一路纯输出的配对虚拟设备满足特殊路由。详见 README.md 的 Developer Guides 一节安装包构建与签名流程参考 Installer/create_installer.sh。 仍解决不了先翻 CHANGELOG.md确认你遇到的问题是否已在新版修复——例如 0.6.1 按 Apple 建议改成了安装后强制重启README.md 的 FAQ 覆盖了位深、多输出、AirPods 等细节安装环节反复失败时用对应声道数的卸载器清场重装脚本见 Uninstaller/create_uninstaller.sh以上都无效再向官方社区求助附上 macOS 版本、BlackHole 声道版本和涉及的应用名能大幅提高沟通效率结语BlackHole 的排障逻辑并不复杂设备在哪里看、驱动文件在不在、权限与时钟源设没设对三件事对了九成的故障就能定位。先跑一遍上面的自检清单再按对应小节动手通常几分钟就能恢复畅通。参考资料README.md · CHANGELOG.md · Installer/ · Uninstaller/【免费下载链接】BlackHoleBlackHole is a modern macOS audio loopback driver that allows applications to pass audio to other applications with zero additional latency.项目地址: https://gitcode.com/gh_mirrors/bl/BlackHole创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考