如何排查问题插件

• Obsidian 的繁荣离不开社区插件市场，诸多作者的分享与贡献。
• 随着你享受这样插件化带来的功能丰富，个性化鲜明的优势同时，你也会遇到很多兼容性问题，有时候对于普通用户，很难会想到这是插件兼容性的问题

问题

我们先来规范几类常见的问题

• 插件和Obsidian 版本不兼容，Obsidian 实际上是存在安装版本的，并不是只要点击升级，你获得 Obsidian 版本就是最新的，有时候官方更新底座，你的升级只更新了上层功能。
• 插件和其他插件不兼容
  • 插件之间在争夺资源，或者单方面某些插件比较慢，阻碍影响了其他插件，亦或者插件和其他插件抢夺资源/操作对象
  • 因为 Obsidian 启动插件的顺序一般不是固定，除非你使用插件管理。否则插件启动的先后也会影响你的判断，因为问题可能有时候出现，有时候不出现
• 插件自身问题
  • 打铁终须自身硬，插件作者的插件质量，是否考虑到了各种情况，是核心本质。但是面对庞大的插件市场，兼容性问题；以及不同用户使用习惯，实际笔记数据的问题。我们很难强迫作者们一定100% 没有 Bug
• 使用问题
  • 也许是你单纯的使用错误
  • 也许是你使用的习惯跟插件设计者不一致
  • 【使用问题不在本次讨论范围内】

方案

下面总结了几种方案来帮助大家确认自己遇到的问题

本方案按快速定位→精准排查→修复验证四步流程，高效解决插件报错、闪退、功能失效等问题，全程落地可操作。

屏蔽大法｜安全模式初筛，排查全局冲突

开启安全模式初筛（排除全局冲突），这步用来判断是不是插件引入的问题

打开Obsidian设置，进入社区插件，开启安全模式，此时所有第三方插件全部禁用。逐一重启开启疑似问题插件，若故障复现，锁定目标插件；若故障消失，判定为多插件冲突，后续逐一配对排查。

升级大法｜优先核对本体与插件版本

• 不管三七二十，先通过覆盖安装方式，升级 Obsidian。
• 先检查插件是否为最新版本，过期版本极易出现兼容bug，一键更新后重启软件。

回忆大法｜从变更记录缩小范围

直接回想下，最近安装了什么插件或者升级了什么插件，这不是说就是这些插件的问题，而是有可能是这些插件升级带来的，ob 版本不兼容，与其他插件不兼容，或者自身问题。

直接对这些插件关闭，检查是否问题消失，如果确认了，反馈给插件作者

进阶方法｜开发者控制台定位底层报错

控制台精准定位（排查深层报错），不看到开发者 几个字就被吓到，操作见到你意想不到

按下 Ctrl+Shift+I（Mac为Cmd+Option+I）打开开发者控制台，查看红色报错信息，匹配插件名称、报错代码，确认是插件bug、配置错误还是文件冲突。随后关闭所有无关插件，仅保留问题插件，最小化环境复现问题。

总结

核心原则：先排除冲突、再查版本日志，最后重置重装，避免盲目操作浪费时间。

当然社区也总结了一些常见插件兼容问题，如 Obsidian插件常见问题 ，新手安装PKMer插件常见问题指南 社区生产的插件，一般也会专门维护和插件兼容性的信息 03_Thino FAQ

讨论

若阁下有独到的见解或新颖的想法，诚邀您在文章下方留言，与大家共同探讨。