反向引用丢失：链接没显示的排查

正常延迟

Logseq 的索引不是实时的——写了新链接后，反向引用面板可能需要几秒到几十秒才能更新。先等 10-30 秒再确认，不要一发现没显示就慌。

排查步骤

第一步：检查链接写法

最简单也最容易出问题的：

• 双括号页面名 — 正确写法
• 方括号文字加圆括号里写双括号页面名 — 错误，这是别名式块引用的写法（用于块引用，不是页面引用）
• 方括号文字加圆括号里写文件路径 — 这是普通 Markdown 链接，Logseq 不会收录到图谱里

第二步：页面名是否精确匹配

Logseq 对页面名的匹配比较严格：

• [[机器学习]] 只匹配 ID 精确等于「机器学习」的页面
• 如果你设了别名 alias:: ML，那 [[ML]] 也能匹配
• 但 [[机器学习方法]] 不匹配「机器学习」页面——这是一个不同的页面

如果你想一个页面自动被部分匹配，设置别名（alias:: 机器学习方法）。

第三步：是否写在不该写的地方

以下位置写 [[链接]] 不会被收录：

• 代码块里（``markdown ... ``）
• 行内代码（[[页面]]）
• URL 链接的锚文本里（把双括号链接嵌在外部 URL 的描述文字里时）
• 属性值里（description:: [[页面]] — 属性值里的链接 Logseq 默认不收录）

如果你需要属性里的链接也被图谱收录，用块级的 [[链接]] 而不是属性值里的。

第四步：索引是不是卡住了

Settings → 搜索「Rebuild search index」→ 重建。索引重建后所有链接关系会重新计算。

第五步：页面是不是被删除/移动过

如果你之前删除过某个页面，然后又创建了同名的页面——Logseq 内部可能存在 ID 冲突。解决：

1. 删掉新创建的同名页面
2. 用不同的名字创建（比如加个后缀）
3. 用 alias:: 指向原始名字

第六步：Logseq 版本问题

极个别的索引 bug 在某些版本里出现过。如果上面都查了还不行：

• 重启 Logseq
• 检查是否有新版本
• 或者在社区论坛（discuss.logseq.com）搜索「linked references not showing」

反向引用里过滤面板

右侧面板的 Linked References 区块顶部有一个过滤选项：

• 可能你之前选了「只显示块级引用」但当前链接是页面级的（或反过来）
• 切换一下选项看看是不是过滤了

一个特殊情况：Org Mode 用户

在 Org Mode 里：

• [[页面名]] 和 Markdown 一样
• [[file:页面名.org]] 是 Org 特有的文件引用写法
• 如果面板没显示，检查你的链接是不是用了 Org 特有的语法

预防

• 写完链接后等几秒再检查面板（默认不会实时更新）
• 频繁出现反向引用丢失时，重建索引
• 不要频繁重命名/删除页面（Logseq 对 rename 有自动更新但可能漏）