插件兼容：升级后插件坏了怎么办

升级后常见问题

升级 Logseq 后可能出现：

• Logseq 启动慢或卡住
• 某些功能不正常（白板、PDF、同步等）
• UI 异常（主题失效、面板错位）
• 插件报红或消失

这些大部分是插件兼容问题——Logseq 每次大版本升级都可能修改插件 API。

排查步骤：二分法

最快定位问题插件的方式是二分法：

1. 打开 Settings → Plugins → 禁用所有已安装的插件
2. 重启 Logseq
3. 检查问题是否消失

• 消失 → 确认是插件问题，继续下一步
• 没消失 → 不是插件问题（可能是配置或 Logseq 本身的 bug）

1. 重新启用一半插件（比如先启用前 5 个）
2. 重启 Logseq → 看问题是否复现
3. 在出问题的那一半里继续二分，直到定位到具体哪个插件

解决方式

找到问题插件后：

方式一：更新插件

Settings → Plugins → Marketplace → 搜索该插件 → 如果有 Update 按钮，点更新。

方式二：卸载

卸载问题插件。寻找替代方案：

• 搜索社区有没有替代插件
• 检查 Logseq 原生功能能不能替代（很多 Obsidian 插件在 Logseq 里是原生的）
• 等待插件作者更新（很多社区插件更新很勤，几天内就会修复）

方式三：暂禁用

如果你还在用 Logseq 原生功能，可以先禁用问题插件让 Logseq 正常工作，等插件更新后再启用。

插件停更怎么办

Logseq 社区有不少插件是个人业余维护的，可能随时停更。如果一个插件连续 3 个月没更新：

• 在 GitHub 上 fork 一份自己维护（如果你会一点编程）
• 搜索有没有其他人已经 fork 并继续维护的版本
• 找替代方案
• 放弃依赖，用 Logseq 原生功能替代

Logseq 插件 API 稳定吗

Logseq 的插件 API 还在快速发展阶段，不稳定——这意味着每次 Logseq 大版本升级都可能导致一批插件失效。

好消息是：

• Logseq 团队会在升级前发布 API 变更日志
• 热门插件的作者通常会第一时间跟进
• 社区有大量 fork 分支可以用

坏消息是：

• 小众插件可能永久失效
• 个人维护的插件可能作者忙了就停更

如何判断插件质量

装插件前先看看：

• 最近一次更新时间（3 个月内更活跃）
• GitHub star / issue 数量（有人用 = 有人维护）
• README 里是否标注了兼容的 Logseq 版本
• 插件作者是否是 Logseq 社区活跃用户

预防：等升级稳定后再更

如果你依赖某些插件，不要第一时间升级 Logseq。等社区反馈稳定后（一般 1-2 周）再升级——那时候主要的插件都已经跟上了。

特别地，Logseq DB vs OG 切换也是插件兼容的分水岭——很多插件只支持其中一种版本。升级或切换前先确认你依赖的插件是否支持目标版本。