安装与启动失败的高频问题处理

安装与启动阶段的问题集中在这四类，官方 FAQ 都有对应答案。

Windows 安装程序卡住

多半是之前卸载不干净，注册表残留了旧条目：

1. Win + R 输入 regedit.exe；
2. 定位到 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Uninstall；
3. 逐个检查子项，找到 DisplayName 值为 "Joplin x.x.x" 的项；
4. 删除该项所在文件夹，重装即可。

动注册表前先导出备份该项。

Linux 桌面版启动不了

两个原因按顺序查：

1. AppImage 没有执行权限：chmod +x 文件名 后再运行；
2. 缺 libfuse2 库：Ubuntu 22.04 等新系统默认不带，安装 libfuse2 即可（AppImage 格式的通用依赖，不是 Joplin 的锅）。

升级后同步与加密密码"消失"

尤其出现在 Mac 从 Intel 版升级到 Apple 芯片原生版（v2.12 起）的场景：应用读不到系统钥匙串里旧版存的凭据。重新输入一遍同步密码和加密密码即恢复，数据没有任何丢失。

Windows 关窗口 = 没退出

开了"显示托盘图标"时，点窗口关闭只是最小化到托盘，应用还在后台跑。要真正退出：

• File 菜单 > Quit；或
• 右键托盘图标 > 退出。

有些配置改动需要重启应用才生效——记得用上面的方式真退出再开。

其他启动异常

通用的排查三板斧：以安全模式启动（禁用插件）、查看应用数据目录是否异常、到官方论坛带版本号与系统信息提问。

具体行为可能随版本变化，以官方最新版为准。