别名 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:::
title::— 用来覆盖页面在 UI 上显示的标题(ID 仍然是文件名/页面名)alias::— 用来增加可引用的别名,不影响显示的标题
比如页面 ID 是 page-2026-10-13,你可以设 title:: 十月份团队会议纪要 让标题好看,但引用时可以用 [[page-2026-10-13]] 或设置别名 alias:: 十月份会议 后用 [[十月份会议]]。
别名常见场景
- 中英文并行:
alias:: Artificial Intelligence和alias:: AI - 缩写与全称:
alias:: 简称指向全称页面 - 错别字容忍:比如有人常写「CAP原则」,你设
alias:: CAP原则指向「CAP 定理」 - 历史名称:技术改名后(如 Vue.js 改 Vue),旧名称设别名继续生效