在 macOS 上安装书笙乐谱（通用包）

一句话：macOS 13 及以上，下载 universal dmg → 拖进「应用程序」→ 首次右键打开即可。

适用于 0.14 及以后的 macOS 版。安装包是一个 universal 通用包：Intel 芯片和 Apple 芯片（M 系列）用同一个文件，不需要先查芯片；系统要求 macOS 13 及以上。

一、在官网下载 macOS 版

打开 ssscore.qzss.top，到「下载」区点 macOS 那张卡，点「下载」拿到的文件名形如 SSScore-0.14-…-macos-universal.dmg，约 141.4 MiB。一个包同时支持两种芯片，不用再分「Apple 芯片版 / Intel 版」。

二、拖进「应用程序」

1. 双击下载好的 .dmg，会打开一个 Finder 窗口；
2. 把窗口里的「书笙乐谱SSScore.app」拖到左边的「应用程序」文件夹；
3. 在 Finder 边栏把挂载的 dmg 推出（点它右边的 ⏏），安装就完成了。

三、第一次打开：右键「打开」

macOS 版目前没有做 Developer ID 签名，也没有经过 Apple 公证，所以第一次双击会被系统拦下。按下面任一种方式放行：

• 在「应用程序」里找到「书笙乐谱SSScore」，按住 Control 点按（或右键）→「打开」→ 在弹窗里再点一次「打开」；
• 如果系统提示「无法验证开发者」，也可以到「系统设置 → 隐私与安全性」，在页面下方点「仍要打开」；
• 如果提示「已损坏」或仍然打不开，打开「终端」执行一次：

xattr -dr com.apple.quarantine "/Applications/书笙乐谱SSScore.app"

然后再双击打开。这个命令只是去掉「从网上下载」的隔离标记，不会改软件内容。以后正常双击即可，不用每次都右键。

装好后打开的样子：左侧「版面」里可以把整谱切成简谱或简线混排

四、第一次启动：音色库在后台补下

安装包里不含播放音色库（约 49 MB）。第一次启动后它会在后台安静下载，不挡着打开谱面；写着写着就好了，关掉软件也会继续下完。只有你在音色没好时点了播放，才会显示下载进度，下完自动接着播。

重装、换安装目录都不会重新下：软件会先在本机找已经下好的那份，找到就直接复用，不联网。下载失败时可以重试，也可以按提示手动放置音色文件。

五、更新：下载 dmg 后手动装

「帮助 → 检查更新」会发现新版本并把 dmg 下载下来，但更新器不能自动安装（未签名的包没有这个权限）。下载完成后：

1. 退出正在运行的旧版；
2. 双击新下载的 dmg，把新的「书笙乐谱SSScore.app」拖进「应用程序」，选择「替换」；
3. 重新打开，在「关于书笙乐谱」里确认版本号。

升级前可以先把旧版 App 复制一份留底；目前不提供自动回滚。

「关于书笙乐谱」里能看到当前版本号

六、常见问题

• Apple 芯片（M1/M2/M3…）能用吗？能，通用包里带了 Apple 芯片切片。不过这一轮 Apple 芯片切片没有在实机上点验，如果你遇到问题，欢迎在软件里「参与共创」反馈。
• 为什么不能自动安装更新？因为安装包未签名、未公证，系统不允许更新器直接替换 App；更新器只负责下载，装的时候需要你手动拖一次。
• 提示「已损坏」怎么办？先按第三节的右键「打开」；仍然不行，就在「终端」执行一次 xattr -dr com.apple.quarantine "/Applications/书笙乐谱SSScore.app"。
• 怎么卸载？退出软件，把「应用程序」里的「书笙乐谱SSScore.app」拖进废纸篓即可；你自己保存的 .mscz 乐谱文件不会被删除。
• Windows / Linux 也升到 0.14 了吗？是，0.14 三端同步发布。Windows 与 Linux 从 0.10、macOS 从 0.11 直接升级；0.11 是 macOS 专属版本，不用补课。

七、已知限制

• 仅支持 macOS 13 及以上；
• 安装包未签名、未公证，首次打开需要右键「打开」或执行上面的 xattr 命令；
• 自动更新不能自动安装，升级需要手动装 dmg；
• Apple 芯片切片本轮未实机点验，遇到问题请反馈；
• 暂不提供自动回滚。

相关教程

书笙乐谱 0.14 版本快讯 · 快速入门：从打开软件到打出第一段简谱 · 在 Linux 上安装书笙乐谱（AppImage）

最后更新：2026-10-30