Logseq 中文文档 下载 App

别名 alias:: 一个页面多个名字

为什么需要别名

你可能有这种困惑:同一个东西在不同语境下被不同的名字提到——有的人写「CAP 定理」,有的人写「CAP Theorem」;有的人写「JavaScript」,有的人写「JS」;有的人写「人工智能」,有的人写「AI」。

如果你分别建三个页面,知识就被切碎了。别名让你只需要维护一个正式页面,其他名字自动指向它。

添加别名

在要设置别名的页面顶部(frontmatter 区域)或任何块里,添加 alias:: 属性:

alias:: JS, JavaScript
alias:: 人工智能, AI, Artificial Intelligence
alias:: CAP 定理, CAP Theorem

多个别名用逗号分隔,或者每个别名单独写一行 alias::。

别名的效果

设置完别名后,在任何块里引用别名都会自动跳转到正式页面:

- 我在写一篇关于 [[AI]] 的综述(点击跳转到「人工智能」页面)
- [[JS]] 是单线程的(点击跳转到「JavaScript」页面)

同时,反向引用也被正确收录——如果有 10 个块用 [[JS]] 引用,「JavaScript」页面的反向引用面板会显示这 10 个来源,不会丢。

别名 vs 命名空间

命名空间用 / 实现分组(如 [[编程语言/JavaScript]]),别名用 alias:: 实现多称呼。它们是不同的能力:

一个页面可以同时有命名空间和别名——比如页面 ID 是 编程语言/JavaScript,同时设置别名 JS 和 javascript。

页面标题 vs 别名

还有一个容易混淆的属性是 title:::

比如页面 ID 是 page-2026-10-13,你可以设 title:: 十月份团队会议纪要 让标题好看,但引用时可以用 [[page-2026-10-13]] 或设置别名 alias:: 十月份会议 后用 [[十月份会议]]。

别名常见场景