故障排查指导 Troubleshooting Guide

发帖前搜索:新建错误报告前,请搜索中英论坛重复话题。

故障排查指导

为修复可能的故障,需要可靠和一致的复现步骤。

你可以先进行以下步骤,看是否解决了故障:

  • 将原库每个插件和主题更新至最新版。
  • 检查 Ob 设置和插件设置里每个选项。Style Settings 插件是最常见需检查的插件。
  • 阅读 Markdown 语法、Obsidian Help、插件说明,检查是否正确应用 YAML 等。

鉴于 Obsidian 中文帮助内容不全,文末简单介绍 YAML,更多还请自行阅读 Obsidian Help

若未解决,首先,排查是否是 Obsidian 本体的问题。

打开沙箱仓库,操作如下图:

不下载任何插件、主题,不启用任何额外 CSS 片段,看在相同操作下能否复现故障。

若沙箱复现:

  • 输入类故障,考虑排查输入法。例如,搜狗输入法默认将数字后的中文句号改为点号。相似问题:微软输入法重复跳字
  • 手动下载 Ob 最新安装包重装,再次沙箱排查,看是否稳定复现。

若确认稳定复现,可将错误报告在 英文论坛“Bug reports”类别(推荐!)或中文论坛“建议反馈”类别。

信息越有质量越完整,越可能得到有用的答案,见 论坛发帖实用指南“求助反馈不重不漏自查表”。若英文论坛报告,可用 Ob 自带命令“显示调试信息”,获取“SYSTEM INFO”。

image

若沙箱不能复现,说明原库有插件、主题、CSS 等冲突。此时话题通常不应发到“建议反馈”类别。

接着,在沙箱依次下载启用你原库加载的插件、主题及额外 CSS 片段,检查里面每个选项,每次新启用后尽量都重启一遍 Ob,看在相同操作下能否复现。

当你找到问题源头,你可以:

  • 在插件/主题的 GitHub 页面报告(推荐!)。
  • 新建类别“疑问解答”,可选标签“插件”/“css”。

附:能用就行的 YAML 简介

YAML 区的内容,代表文档的信息,“元数据”,英文为 Metadata、Properties 等。
混淆 YAML 含义所致错误,可参 Dataview 插件,flatten 分行问题

源码模式的 YAML,对应 Ob 设置 - 编辑器 - 文档属性 - 显示,图形化的 YAML:

作为一种成熟的标记语言,Ob 的 YAML 和一般的 YAML 没什么区别,都是注意全英文符号、字符串两边双引号等。有了文档属性视图将 YAML 区图形化,基本是傻瓜式操作。

在插件、主题、CSS 说明中找到具体需要的文档属性和值,首行空行输入三个 -,或标签右键 - 增加文档属性,或快捷键,可添加 YAML。

image

一个添加 YAML 的实例:Markmind 无法调用、工具栏没有按钮

2 个赞
CSS:剧本对白 Screenplay
obsidian完全无法正常打开和编辑文章,出现app.js:1 TypeError
请问我重新装了obsidian的这两个思维导图插件后发现用不了
论坛发帖实用指南:入门培训、回复多人、善用链接
【Bug Report】1.8.0下Canvas的中文输入出现Bug
阅读模式下标题折叠BUG
打开特定Md文档时候卡顿
中文冒号加粗bug
堆叠标签页功能下,鼠标框选文字时会导致标签页滑动。
iPad 版本+中文输入法状态下,按下快捷键(如cmd+B,加粗)会上屏输入字母,严重影响使用
当笔记中有很大表格的时候,通过左上角自带搜索有重复出现的关键字并通过最后一个的搜索结果进入此笔记,几乎100%会出现内容丢失
按键盘上的菜单键,出现的菜单会一直重复叠加出现
堆叠标签页功能无法正常激活标签页
为什么我的打开时只有一条白线,怎么办
Obsidian 在Callout内嵌入笔记,限制预览窗口最大高度后,内嵌文件的callout显示不全
阅读视图内链无法跳转
严重问题,更新后无法启动
BUG:Obsidian 1.8.4版本使用百度网盘同步空间自动同步文件错误
v1.8.9 链接预览时无法点击放大图片
【解答合集】YAML 变分割线,HTML 不显示,\ 转义或 `` 包裹 各种语法问题
Obsidian Mermaid 的 ER 图表语法不支持中文?
macOS端经常弹窗A JavaScript error occurred in the main process
obsidian 渲染画面显示不全该如何解决?
希望修复Obsidian目录抖动的bug