30秒速读
在 Mac 上听 YouTube Music，网页版总被信息流打断，只想专心听当前这首歌、看逐词歌词，qtube-music就是为此做的 macOS 原生客户端：全屏播放、逐词歌词与翻译、歌曲与音乐视频一键切换。本篇讲它怎么装、歌词怎么调，以及它明确不做的事。
GitHub 国内访问较慢，如打不开可多刷新几次。
项目信息表
| 项目 | qtube-music |
|---|---|
| 定位 | macOS 原生 YouTube Music 客户端 |
| 支持平台 | macOS |
| 界面技术 | SwiftUI 与 AppKit 构建，支持系统控制、菜单与快捷键 |
| 核心能力 | 全屏 Stage、逐词同步歌词与翻译、桌面歌词、迷你播放器、歌曲与音乐视频切换 |
| 歌词来源 | YouTube Music、LRCLIB、AMLL TTML DB；网易云音乐、酷狗音乐、QQ 音乐来源需选择启用 |
| 界面语言 | 英语与简体中文，支持浅色与深色模式 |
| 许可证 | MPL-2.0 |
| 获取方式 | 从项目仓库 Releases 页面下载，具体版本与系统要求以仓库说明为准 |
上手指南
- 从仓库 Releases 下载 macOS 安装包并安装，首次打开先不登录，直接浏览和播放可访问内容，确认播放和界面都正常。
- 需要看自己的歌单和音乐库时再登录 YouTube Music 账号；未登录只能浏览和播放可访问内容，这是正常限制，不是故障。
- 打开一首歌进入全屏 Stage，试三种布局和不同背景，找到自己看着舒服的组合：封面、黑胶唱片、音乐视频或音频响应可视化效果。
- 歌词对不上时先调时间偏移，再换歌词版本：如果当前版本没有逐词数据，卡拉 OK 式逐词效果就出不来，换一个来源版本往往能解决。
- 需要边干活边听时切到桌面歌词或迷你播放器，歌词和控制都在手边，不用每次都切回主窗口。
装完先做三件事：第一，在设置里确认歌词来源和启用项，国内用户如需网易云音乐等来源要手动选择启用；第二，试一次歌曲与音乐视频切换，确认切换后播放位置保持连续；第三，记一两个常用快捷键，暂停、切歌不用鼠标点来点去。
明确取舍：适合谁，不适合谁
| 场景 | 建议 |
|---|---|
| Mac 用户，主力听 YouTube Music，重全屏与歌词体验 | 适合，这是它最擅长的场景 |
| 想去掉网页信息流干扰，只专注当前播放歌曲 | 适合，产品定位就是聚焦播放本身 |
| 需要播客、Shorts、评论或完整网页功能 | 不适合，它不做这些，仍需回网页端 |
| 需要官方支持，或 Windows、手机等多平台通用 | 不适合，它是非官方客户端且只做 macOS |
| 要求歌词服务永远稳定、不受上游变化影响 | 不适合，播放与歌词都依赖 YouTube Music 及多个歌词来源 |
一句话结论：qtube-music 是给 Mac 上 YouTube Music 重度听众的专注播放器，不是 YouTube Music 网页版的完整替代品，冲着歌词和全屏来就值，冲着全功能来会失望。
常见问题
问：它是官方客户端吗？不是。据项目说明，它是非官方 YouTube Music 客户端，不由 Google 或 YouTube 制作、认可或支持，介意这一点就不要把它当官方产品用。
问：为什么有的歌没有逐词歌词？逐词效果依赖歌词来源是否提供逐词时间信息，并非所有歌曲都有。可以换歌词版本、报告错误，或直接关闭歌词，先确认是不是来源数据本身缺失。
问：免费账号能用吗，会有广告吗？据项目说明支持免费账户，免费账户播放行为与网页端相同，可能包含广告；查看个人音乐库则需要登录账号。
问：歌曲切到音乐视频后进度会丢吗？据项目说明，切换时强调保持当前播放位置。如果某首歌切换后进度异常，先检查是不是该歌曲本身没有对应音乐视频版本。
问：升级后歌词或切换功能变了怎么办？先回仓库看发行说明，确认是不是上游服务或 macOS 接口变化，再逐项核验歌词来源、翻译和视频切换是否仍然可用。
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
