页面别名 (Aliases)

页面别名 (Aliases)

页面别名功能允许一个页面通过多个不同的URL访问，适用于URL重构、创建短链接、多语言路径等场景。

基本用法

在页面的 frontmatter 中添加 aliases 字段：

MARKDOWN
---
title: 配置指南
permalink: /configuration/
aliases:
  - /config/          # 短链接
  - /旧配置/          # 旧URL
  - /settings/        # 别名URL
---

这是配置指南的内容...

访问任何一个别名URL都会显示与主URL完全相同的内容。

工作原理

系统会将页面的完整内容复制到每个别名路径，并添加 canonical 标签：

  • 完整内容：别名页面包含所有内容、样式和脚本
  • 统计追踪：网站统计能正常追踪别名URL的访问
  • Canonical标签：告知搜索引擎主URL，避免重复内容惩罚
  • 用户体验：无需等待跳转，直接看到内容

应用场景

URL重构

MARKDOWN
---
title: 快速开始
permalink: /docs/getting-started/
aliases:
  - /quick-start/           # 旧版URL
---

短链接

MARKDOWN
---
title: 如何使用双链笔记
permalink: /tutorials/wikilinks-guide/
aliases:
  - /wikilinks/    # 简短好记
  - /双链/         # 中文路径
---

多语言路径

MARKDOWN
---
title: 关于我
permalink: /about/
aliases:
  - /关于/
  - /about-me/
---

注意事项

系统会自动检测以下情况并给出警告：

  • 别名与现有页面URL冲突 - 将跳过该别名
  • 多个页面使用同一别名 - 只有第一个会生效
  • 别名与主URL相同 - 属于冗余配置，建议移除

URL格式

系统会自动标准化URL格式：

MARKDOWN
---
aliases:
  - /my-page      # 自动补全为 /my-page/
  - my-page       # 自动添加 / 变为 /my-page/
---

建议直接使用 /path/ 格式（以 / 开头和结尾）。

常见问题

Q: 别名不生效？

检查以下几点：

  • aliases 拼写是否正确
  • 值是否为数组格式（使用 - 开头）
  • 查看构建日志是否有警告

Q: 别名会影响SEO吗？

不会。重定向文件包含 canonical 标签和 noindex 指令，搜索引擎会正确识别。

相关文档