Mac ARM64 启动 Joplin 报错 EACCES: permission denied 解决方案

发表于 更新于 分类于 ， ， 阅读次数： 评论数：

Mac ARM64 启动 Joplin 报错 EACCES: permission denied 解决方案

适用于 Apple Silicon（M1 / M2 / M3 / M4）+ macOS 的 Joplin Desktop 启动失败问题。

一、问题现象

在 macOS（ARM64）上启动 Joplin Desktop 时，应用直接闪退或弹出错误窗口，日志内容如下：

1
2
3
4
5
6

Uncaught Exception:
Error: EACCES: permission denied, mkdir '/Users/lixiao/.config/joplin-desktop'
    at Object.mkdirSync (node:fs:1363:26)
    at ...

错误关键信息：

  • ❌ EACCES: permission denied

  • ❌ 无法创建目录 ~/.config/joplin-desktop

二、错误原因分析（重点）

这个问题与 ARM64 架构无关，也不是 Joplin 本身的 bug，而是一个典型的 macOS 目录权限问题。

Joplin Desktop 在启动时会尝试创建并写入以下配置目录：

1
2
3

/Users/<username>/.config/joplin-desktop

当出现以下任一情况时，就会直接启动失败：

  1. ~/.config 目录不存在

  2. .config 目录 不属于当前用户（owner 是 root）

  3. 曾经使用 sudo 启动过 Joplin GUI

  4. 通过 Time Machine / 迁移助手 导致权限错乱

三、快速解决方案（推荐）

适合 99% 的用户，安全、直接、可回滚

1️⃣ 打开终端，执行以下命令

1
2
3
4
sudo mkdir -p /Users/lixiao/.config
sudo chown -R lixiao:staff /Users/lixiao/.config
chmod 700 /Users/lixiao/.config

然后重新启动 Joplin Desktop。

四、已存在目录但权限错误的情况

1️⃣ 检查当前权限

1
2
ls -ld /Users/lixiao/.config

如果你看到类似输出：

1
2
3

drwx------  root  wheel  .config

说明 .config 目录被 root 占有，这正是问题根源。

2️⃣ 修复权限

1
2
sudo chown -R lixiao:staff /Users/lixiao/.config

五、只修复 Joplin 目录（保守方案）

如果你不希望改动整个 .config 目录，可单独处理 Joplin：

1
2
3
4
mkdir -p ~/.config/joplin-desktop
sudo chown -R lixiao:staff ~/.config/joplin-desktop
chmod 700 ~/.config/joplin-desktop

六、常见“踩坑”原因说明

❌ 使用 sudo 启动 GUI 应用

1
2
sudo /Applications/Joplin.app/Contents/MacOS/Joplin

这是 macOS 上非常不推荐的操作，会导致：

  • 配置目录被 root 创建

  • 后续普通启动全部失败

✅ 正确方式：

  • 直接从 Launchpad / Finder 启动

  • 或使用 open -a Joplin

七、macOS 隐私与安全性补充检查（少数情况）

路径：

1
2
3

系统设置 → 隐私与安全性 → 完全磁盘访问

建议确保以下应用被允许：

  • Joplin

  • Terminal（如果你用终端调试过）

不是必须条件，但可避免边缘权限问题

八、终极兜底方案（适合首次使用）

如果你不在乎现有配置或是第一次使用 Joplin：

1
2
rm -rf ~/.config/joplin-desktop

然后重新启动 Joplin，程序会自动重建目录。

九、问题总结

| 项目 | 说明 |

| ————- | —————————— |
| 报错原因 | 无权限创建 ~/.config/joplin-desktop |

| 是否 ARM64 Bug | ❌ 否 |
| 是否 Joplin Bug | ❌ 否 |

| 核心解决思路 | 修复目录 owner 和权限 |

十、延伸阅读 / 相关问题

  • macOS 下为什么不应该用 sudo 启动 GUI

  • Joplin Desktop 配置目录结构解析

  • 自建 Joplin Server + macOS 客户端同步

  • Joplin 数据迁移与备份方案

结语

这是一个macOS 用户非常常见、但第一次遇到会很迷惑的问题。只要记住一句话：

Joplin 启动失败，多半是配置目录权限不属于你。

修好权限，Joplin 就会立刻恢复正常。

如果你正在使用 自建 Joplin Server，或遇到同步 / 加密 / 迁移问题，也可以继续交流。👋