常见问题

安装和使用中最常遇到的问题。

插件市场一直转圈,或者提示安装失败

插件市场的列表和文件都是从 GitHub 下载的,国内网络经常连不上或很慢。不用反复重试,直接用离线包安装,文件和插件市场里的完全一样。

文件放进去了,但「已安装插件」里没有

按顺序检查:

  1. 路径对不对:应该是 库/.obsidian/plugins/gogoga-mindmap/main.js。常见错误是多套了一层文件夹(plugins/gogoga-mindmap/gogoga-mindmap/),或者放进了别的库。
  2. 文件齐不齐:至少要有 main.js 和 manifest.json。从 GitHub 下载时不要下「Source code」压缩包,那是源码,Obsidian 用不了。
  3. 重启过没有:完全退出 Obsidian 再打开,或者在「第三方插件」里点刷新按钮。
  4. 安全模式关了没有:设置 → 第三方插件,「安全模式」(受限模式)开着时第三方插件都不会加载。

主题选了没有变化

  • 主题文件夹必须叫 gogoga,路径是 库/.obsidian/themes/gogoga/theme.css。
  • 在 设置 → 外观 → 主题 里确认选中的是 gogoga。
  • 如果开了自己的 CSS 片段(设置 → 外观 → CSS 代码片段),先全部关掉看看是不是冲突。

主题的「荧光笔记」等选项在哪里调

主题的开关通过 Style Settings 插件提供界面。在插件市场安装 Style Settings 并启用后,设置里会多出一个 Style Settings 页面,gogoga 的选项都在里面。

离线包和插件市场的版本一样吗

一样。本站每次都从 GitHub Release 自动同步,离线包里的 main.js、manifest.json、styles.css 和插件市场下载的是同一份文件。下载页列出了每个文件的 SHA-256,可以自己核对。

离线装的插件,以后还能从插件市场更新吗

能。已上架插件市场的插件,离线装好后插件 id 一样,Obsidian 会照常在「第三方插件」里提示更新(前提是那时能连上 GitHub)。连不上的话,就下载新的离线包覆盖。

更新会不会丢设置

不会。插件的设置保存在插件文件夹里的 data.json,离线包里没有这个文件,覆盖安装不会动它。

手机上怎么装

见安装教程的手机上安装。简单说:iPhone 建议先在电脑上装好再同步过去;Android 可以用能显示隐藏文件的文件管理器直接放。

遇到 bug 或者想提建议

到对应插件的 GitHub 仓库提 Issue,中英文都可以:

提问时附上 Obsidian 版本、插件版本、操作系统,最好再附一张截图,能更快定位问题。