第 7 章 · 插件安装与扩展

1. 插件是什么

Joplin 插件是基于 JavaScript 的扩展模块，可增强编辑器、添加工具栏按钮、自动化流程、接入外部服务。官方插件库已有超过 200 个插件。插件 API 提供编辑器操作、对话框、设置项与数据读写能力，插件通过 npm 打包分发，官方插件库会自动校验更新。

也正因为插件能读写笔记、调用系统接口甚至访问网络，它和「换个皮肤」不是一回事：主题只改样式，插件会真正执行代码。桌面端版本太旧时，新插件可能装不上或装完没反应，遇到这种情况先看 Joplin 是否为较新版本。插件只在桌面端加载，手机和 iPad 上安装的插件不会生效，但插件生成的笔记内容（比如模板笔记、看板数据）仍能正常同步查看。

2. 安装与更新插件

1. 打开「设置 → 插件」，点击「浏览插件」。
2. 搜索名称并点击「安装」，重启后生效。
3. 在插件管理器中可启用、禁用、卸载或更新插件。

尽量只从官方插件库安装插件，第三方插件可能读取你的笔记内容。安装后若发现异常，可以在插件管理器中先禁用再排查，不必卸载重装。插件更新会随 Joplin 桌面端自动检查，也可以手动在插件管理器中点击更新；更新后如遇兼容问题，可回退到上一版本。

插件装好后，它的设置入口通常在「设置 → 插件」里点开插件名称，也有插件会把自己的菜单加到「工具」或编辑器右键菜单中，找不到按钮时先重启一次应用。排查插件冲突最省事的办法是「二分禁用」：先把插件全部禁用，确认 Joplin 恢复正常，再一半一半地重新启用，很快就能定位到出问题的那一个。Joplin 大版本升级后个别插件会暂时失效，先检查是否有新版插件，而不是急着重装应用。

3. 实用插件推荐

完整的分场景推荐清单（含 10 款必备插件的功能与适合人群对比）见 Joplin 插件推荐。这里给出入门三件套：Templates（模板）、Inline TODOs（行内待办）、Calendar（日历），足以覆盖「模板、任务、日程」基础需求。更多插件可在官方插件库 joplinapp.org/plugins 浏览，也可以直接查看 GitHub 仓库 的插件目录。社区主题可以在插件库中搜索 theme 关键词找到。

4. 主题与外观

「设置 → 外观」中可切换浅色 / 深色主题并跟随系统；也可安装社区主题或直接编辑自定义 CSS。实战见主题美化教程。主题与插件的官方说明见 插件与主题文档，改坏样式时可随时恢复默认主题。插件开发入门见 插件开发教程，常见问题见 手册第 10 章。

5. 插件开发入门

Joplin 提供完整插件 API（笔记读取、编辑器操作、对话框、设置项等），开发只需 JavaScript 基础与 Node.js 环境，入门见插件开发教程。

6. 插件维护与排查清单

插件是「装完还要管」的部分。建议每月打开一次插件管理器：更新有新版的那几个，卸载半年没用过的，顺便看一眼每个插件申请了哪些权限。装得越多，启动越慢、越容易互相抢快捷键，常见症状是命令面板里出现重复命令、工具栏按钮错位，或切换笔记时明显卡顿。多设备用户还要记住一件事：插件不会跟着同步走，每台电脑都要单独安装并各自配置一遍。

• 插件毫无反应：确认已重启应用、插件处于启用状态，且桌面端版本满足插件要求。
• 快捷键失灵：多半是插件与内置快捷键冲突，到「设置 → 键盘快捷键」改掉其中一条。
• 界面错乱：先禁用主题类插件恢复默认外观，再逐个排查其他插件。
• 升级后失效：等插件作者发布兼容版本，或临时回退 Joplin 版本；期间笔记数据不受影响。

动手排查之前先导出一次 JEX 备份，虽然插件故障极少损坏笔记，但养成这个习惯可以让任何实验都没有后顾之忧。插件清单与分场景推荐见 插件推荐，官方说明见 插件与主题文档。