常见问题

按主题分组。每条前面是症状，后面是按顺序排查的步骤——从上往下试，不要跳步。

安装与启动

打开是空白界面

三个可能，按顺序排：

1. 安装路径含中文或空格 → 换成纯英文路径
2. 显卡/渲染兼容问题 → 启动时关闭硬件加速
3. 配置损坏 → 把配置目录改名（不是删除），重启让它重建

更新之后设置全没了

更新有时会重置配置目录。更新前先备份配置，更新后如果丢了，把备份目录拷回去。

装好了但侧边栏没有 Notebook Navigator

先在「设置 → 第三方插件」确认它处于已启用状态，community plugins 默认需要手动开。启用后如果还不显示，检查是不是把左侧栏折叠了。

显示与布局

左侧目录不见了

多半是误按了折叠按钮，或者窗口太窄自动收起。把窗口拉宽，或找界面上的侧栏开关。

预览区显示乱码

编码不是 UTF-8。用编辑器另存为 UTF-8 再打开。

双栏挤在一起，字被压成一列

窗口宽度不够。笔记本屏幕建议至少 1280 宽，窄屏时把右栏收起，只用左栏 + 编辑区。

搜索与筛选

搜不到明明存在的文件

按顺序查：

1. 是否只搜了文件名 → 切成全文搜索
2. 索引是否还没建完 → 等它跑完，或手动重建索引
3. 文件是否在被排除的目录里（如归档、隐藏目录）

搜索结果里有很多无关的

不是搜索的问题，是内容里出现了太多通用词。给关键内容加标签，用标签筛选缩小范围。

过滤搜索的命令写了没反应

最常见三个原因：标签少了 #、属性用了中文引号、日期格式写成 2026/11/1 而不是 @last30d 这类相对写法。对照 3.1 过滤搜索 的示例逐字检查。

同步

两台机器上的内容对不上

先确认同步任务是否真的跑完了，再看有没有冲突文件。多数同步工具冲突时会生成 xxx (冲突副本) 这样的文件，需要手动合并。

同步之后文件时间全变了

正常。同步会重写文件，修改时间变成同步时间。重要内容建议在正文里也写日期。

手机上看到的内容比电脑少

移动端有时不会立即拉取全部附件和插件数据。先手动触发一次同步，再看是否完整。彻底方案是只用同步工具同步 Markdown 本体，附件按需下载。

性能

文件多了之后很卡

按影响从大到小：

1. 关闭缩略图（尤其是网络盘上的）
2. 减少实时预览的行数
3. 把超过半年没动的内容移到归档目录，并排除出索引
4. 关掉不用的插件

打开单个大文件就卡

超过五千行的笔记，实时预览本身就很吃力。切成编辑模式，或者把长文拆成几篇用链接串起来。

数据与安全

误删了笔记能找回来吗

先看 Obsidian 的「文件恢复」功能，里面有按时间的历史快照。没有的话看系统回收站，最后才看备份。从这一刻起，立刻补上自动备份。

Vault 能不能直接放网盘同步目录

可以用，但要知道代价：网盘同步可能在文件写入一半时上传，导致文件损坏；多人同时改会冲突。稳妥做法是本地放 Vault，用备份和定时同步，别让它实时双向同步。

还是没解决

按这个顺序，九成问题能定位：

换默认配置，看问题是否复现 → 复现说明不是配置问题

关掉全部插件 → 不复现说明是某个插件

新建一个空目录测试 → 正常说明是原目录的数据问题

以上都正常 → 才去查版本和更新日志

报问题时带上三个信息

版本号、操作系统、复现步骤。有这三样，别人一眼就能判断；只写「用不了」，谁也没法帮。