Joplin

Joplin 是开源笔记与待办应用，支持 Markdown、附件和多平台桌面端，适合整理研究资料、会议记录与个人清单。本文聚焦 v3.7.21 桌面版下载、首次建立本地笔记和同步准备；同步需由用户配置目标服务，不等同于云空间或备份。

Joplin 笔记与待办

Joplin 可用笔记本和标签组织笔记及待办事项，并在桌面端编辑 Markdown。附件和导出能力依当前应用版本而定。桌面资料与移动端可以分开安装，本文只介绍桌面版。

Windows、macOS、Linux 下载和启动

打开 官方 v3.7.21 安装说明：

• Windows：页面列有32位和64位 Setup 安装程序；便携版另列为 Portable EXE。下载后运行对应安装包并启动 Joplin。
• macOS：从官方桌面下载入口选择该设备支持的安装包；打开 DMG 并将应用移入 Applications。芯片与最低macOS版本以当前下载页为准。
• Linux：按官方说明使用推荐安装脚本，或从 v3.7.21 release 选择对应架构 AppImage/发行包。不要将 Windows 文件当成 Linux 安装器。

首次启动后可先新建笔记本和一条本地笔记，确认所选桌面端能打开编辑，再决定是否配置同步。以上依官方文档整理，未实机安装；不同发行版命令和安装方式请看原始页面。

同步、导出与故障入口

同步需在设置中选择目标并填写该服务所需信息；Joplin 本身不提供所有同步目标的云存储空间。若同步失败，先在同步设置查看错误文本，再按官方同步指南核对目标、账户授权和连接设置。不要在不明配置下重复覆盖数据。要另存副本或迁移数据，先查官方导出说明；同步不能当作独立备份。

v3.7.21 桌面版更新

官方发布于 2026-09-25 21:31 UTC（北京时间 2026-09-26 05:31）。更新修复 ENEX 导入时未转义 ampersand 导致失败、AppImage 启动窗口类设置问题，以及 Joplin Server 对项目返回 HTTP 422 时的同步死锁。固定版本日志见 官方 v3.7.21 release；上述为Desktop版本发布项。

常见问题

Joplin 是否收费？ 应用采用 AGPL-3.0-or-later；不同同步目标或第三方服务可能有自己的费用。 没有配置同步可以先用吗？ 可以先在本机新建笔记；同步是另行设置的功能。离线行为未在本次实测。 同步报错从哪里查？ 记录同步错误提示，并对照官方同步配置文档检查目标和授权；不要将同步异常描述成数据已成功上传。 下载后如何选择Windows版本？ 官方v3.7.21安装文档列出32/64位Setup和Portable EXE，按设备选择。

来源与核验日期：2026-10-15（Asia/Shanghai）。开发者/发起者 Laurent Cozic；本文为文档整理，未实机验证安装、同步和导出。