📚 课程目录第3章页面层级与信息架构

3. 页面层级与信息架构

在 Confluence 中，页面不是孤立存在的文档，而是挂在一棵“页面树”上的节点。页面树决定了读者从空间首页出发，经过几次点击能到达目标文档；也决定了权限、搜索权重、宏引用和后续维护成本。研发团队常见的困境是：文档写了不少，但新人找不到接口说明，测试找不到环境配置，运维找不到发布记录。问题往往不在内容质量，而在信息架构没有按研发认知习惯组织。

本节围绕四个核心对象展开：页面树（整体骨架）、父页面与子页面（层级关系）、快捷方式（跨空间跳转）、索引页（聚合入口）。理解它们的分工，才能设计出“找得到、看得懂、维护得起”的文档导航结构。

一、页面树：用层级表达研发对象的归属

Confluence 的页面树本质是一棵有根树：空间首页是根，每个页面最多有一个父页面，可以有多个子页面。层级深度建议控制在 3～4 层，超过 4 层后，面包屑导航会变长，读者容易迷失。研发文档的层级通常对应“领域 → 子系统 → 模块 → 具体文档”的认知路径。

以“支付平台”空间为例，可以设计如下页面树：

支付平台空间首页
├── 01 平台总览（父页面）
│   ├── 架构全景图
│   ├── 术语表
│   └── 版本发布记录
├── 02 核心服务（父页面）
│   ├── 交易服务
│   │   ├── 接口说明
│   │   └── 状态机设计
│   ├── 账务服务
│   │   ├── 记账规则
│   │   └── 对账流程
│   └── 风控服务
│       ├── 规则引擎
│       └── 名单管理
├── 03 接入指南（父页面）
│   ├── 快速开始
│   ├── SDK 使用
│   └── 常见问题
└── 04 运维手册（父页面）
    ├── 部署拓扑
    ├── 监控告警
    └── 故障预案

这里的关键不是“分几层”，而是每一层的划分依据必须一致。上例中第一层按“文档用途”划分（总览、服务、接入、运维），第二层按“子系统”划分，第三层按“文档类型”划分。如果同一层里既有按子系统分的，又有按文档类型分的，读者就无法形成稳定预期。

二、父页面与子页面：父页面是“导航页”，不是“大杂烩”

父页面的核心职责是导航与摘要，而不是把所有子页面内容复制一遍。一个合格的父页面通常包含：本领域一句话定位、子页面清单（带一句话说明）、关键联系人、最近更新时间。Confluence 提供了“子页面显示”宏（Children Display），可以自动列出子页面，避免手工维护清单导致遗漏。

子页面则承担具体内容。判断一个内容该不该独立成子页面，可以用一个简单标准：它是否会被其他页面单独引用或单独授权。如果“接口说明”会被多个项目页引用，就应该独立成子页面；如果只是父页面里的一段补充说明，直接写在父页面即可，避免产生大量“只有三行字”的碎片页面。

父页面标题建议带序号前缀（如“02 核心服务”），这样在页面树和搜索结果中排序稳定，读者也能通过序号快速判断层级位置。序号一旦确定，不要频繁调整，否则会破坏已建立的认知。

三、快捷方式：跨空间跳转的“传送门”

研发文档往往分散在多个空间：产品空间、研发空间、测试空间、运维空间。快捷方式（Shortcut）是 Confluence 空间级别的一种特殊页面，它不承载正文，只保存一个目标链接，点击后直接跳转到目标页面或外部系统。

快捷方式适合以下场景：

从研发空间快速跳到测试空间的“用例库首页”；
从运维手册跳到监控平台（Grafana、Prometheus）的外部地址；
从接入指南跳到 API 网关的在线调试页面。

使用快捷方式时要注意两点：一是命名要能自解释，例如“测试用例库（测试空间）”比“点这里”更清晰；二是定期检查链接有效性，外部系统地址变更后，快捷方式会变成死链，建议每季度巡检一次。

四、索引页：让“找不到”变成“查得到”

索引页是信息架构的“检索层”，它不依赖页面树的层级路径，而是按读者可能的检索维度重新聚合页面。常见的索引维度包括：按角色（新人、开发、测试、运维）、按文档类型（接口、设计、规范、复盘）、按时间（最近更新、版本发布）。

Confluence 中实现索引页的常用手段有三种：

标签 + 页面树宏：给页面打上统一标签（如 doc-type:api），用“页面树”宏按标签过滤展示；
内容报告宏：按空间、标签、更新时间自动生成列表，适合做“最近更新”索引；
手工维护的表格：适合页面数量少、需要人工排序和补充说明的场景，但维护成本高，页面多了容易过期。

索引页本身应该放在页面树的顶层或次顶层，确保读者从空间首页最多两次点击就能到达。索引页的标题建议统一为“XX 索引”或“XX 导航”，便于搜索识别。

五、把四者组合成可维护的导航结构

页面树、父子页面、快捷方式、索引页不是四套独立机制，而是一套组合拳。下面的 SVG 展示了它们在一个研发空间中的协作关系：页面树提供纵向层级，快捷方式提供横向跨空间跳转，索引页提供按维度的聚合入口，父页面则作为层级中的导航节点。

从图中可以看到：页面树是纵向骨架，父页面是骨架上的“关节”，子页面是“肌肉”，索引页和快捷方式是横向的“韧带”，把不同分支和不同空间连接起来。四者各司其职，缺一不可。

六、落地检查清单

设计完成后，建议用以下清单做一次自检：

检查项	合格标准	常见问题
层级深度	从空间首页到最深层页面不超过 4 次点击	层级过深，面包屑过长
同级划分依据	同一层使用同一分类维度	混用“按子系统”和“按文档类型”
父页面内容	包含定位、子页面清单、联系人	父页面堆满正文，子页面空置
索引页覆盖	至少覆盖角色、类型两个维度	只有页面树，没有聚合入口
快捷方式有效性	每季度巡检一次，无死链	外部系统迁移后未更新
命名一致性	父页面带序号，子页面命名风格统一	中英文混用、序号随意跳号

不要为了“看起来整齐”而创建大量空父页面。一个父页面如果长期没有子页面，就应该合并到上级页面或删除。空节点会稀释页面树的信息密度，反而增加读者的判断成本。

信息架构不是一次设计就永久不变的。随着团队规模扩大、系统拆分、文档类型增加，页面树需要定期重构。建议每半年做一次“页面树体检”：统计各层级页面数量、识别孤立页面（没有父页面或没有子页面）、检查索引页是否覆盖了新增的文档类型。把信息架构当作代码一样维护，才能让 Confluence 真正成为研发团队可信赖的知识入口。