macOS 版下载安装与 Apple 芯片版本选择

macOS 版安装包区分芯片架构，选错包通常表现为能装但性能或兼容性异常，值得先弄清楚再下。

选对芯片版本

• Apple Silicon（M1/M2/M3/M4 系列）：下载 Apple Silicon 版。较新版本已原生支持 M 系列芯片，无需 Rosetta 转译；
• Intel 芯片：下载 Intel 版。

不确定自己的芯片型号，点左上角苹果菜单 > 关于本机，看"芯片"一栏即可。

安装步骤

1. 获取对应芯片的 macOS 安装包（DMG 镜像）；
2. 打开 DMG，把 Joplin 图标拖进 Applications（应用程序）文件夹；
3. 首次启动如提示"来自未知开发者"，右键点击应用图标选择"打开"，或在系统设置的隐私与安全性里放行。

首次配置

• 菜单路径在 macOS 上是 Joplin > Preferences（快捷键 Cmd+,）打开配置界面；
• 同样可以在配置里切换中文界面；
• 通知权限：待办提醒依赖系统通知，首次设置闹钟时按提示授权。

一个已知的升级坑

官方 FAQ 提到：从旧版本升级到支持 Apple 芯片原生运行的大版本（v2.12 起）时，应用可能读不到系统钥匙串里旧版存的凭据，表现为同步密码和加密密码"消失"。处理方式很简单：重新输入一遍密码即可，数据并未丢失。

下一步

• 在 iPhone 或 iPad 上也装一个？看移动版安装；
• 配置 iCloud 之外的同步（iCloud 不是官方支持的同步目标）：看同步机制总览。

安装包版本以官方最新版为准。