📚 课程目录第3章 Confluence核心概念入门

3. Confluence核心概念入门

Confluence 不是“共享网盘”，也不是“在线 Word”。它是一套以空间（Space）为边界、以页面（Page）为知识载体、以权限（Permission）为访问控制、以协作机制为持续演进动力的团队知识平台。理解这七个核心概念及其相互关系，是后续所有实操的前提。

一、空间：内容的容器与权限边界

空间是 Confluence 中最高层级的内容组织单元，可以理解为“一个项目/团队/产品线的独立知识库”。每个空间拥有独立的页面树、独立的权限设置、独立的博客流。常见空间类型包括：

团队空间：如“研发中心”“测试组”，用于沉淀团队规范、会议纪要、值班表。
项目空间：如“支付网关重构”，用于承载需求、设计、接口、发布记录。
知识库空间：如“运维手册”，面向全公司开放只读。
个人空间：每位用户默认拥有，用于草稿与个人笔记。

空间键（Space Key）是空间的唯一短标识，例如创建“支付网关重构”空间时键可设为 PAYGW，之后页面 URL 形如 /spaces/PAYGW/pages/123456。空间键一旦确定不建议修改，因为会影响已有链接。

二、页面：知识的基本单元与父子树

页面是 Confluence 中真正承载内容的对象。每个页面有标题、正文、作者、版本号、父页面。页面之间通过“父—子”关系形成树状结构，这棵树的根就是空间首页。例如：

PAYGW 空间首页
├── 01 项目概览
├── 02 需求文档
│   ├── 2.1 支付下单需求
│   └── 2.2 退款需求
├── 03 技术设计
│   ├── 3.1 接口设计
│   └── 3.2 数据库设计
└── 04 发布记录

页面不是“写完就结束”的静态文档。每次保存都会生成一个新版本，版本号从 1 递增。点击“页面历史”可以查看任意两个版本的差异（Diff），并支持回滚。这是 Confluence 区别于普通文档工具的关键能力：内容可追溯、可回退。

三、博客：面向时间流的内容形态

博客（Blog）与页面同属空间内容，但组织方式不同：页面按树状层级组织，博客按时间倒序排列。博客适合发布“有明确时间点、不需要长期维护”的内容，例如：

每周迭代发布说明
线上故障复盘通告
团队活动通知

博客同样支持评论、点赞、@提及，但一般不参与页面树的层级导航。判断标准很简单：内容是否需要一个固定位置被长期引用？是则用页面，否则用博客。

四、模板：把重复结构固化为可复用起点

模板（Template）是预置了结构和占位内容的页面骨架。当团队反复创建同类页面时，模板能显著降低遗漏关键字段的概率。例如“故障复盘”模板可预置以下结构：

字段	说明	示例
故障等级	P0/P1/P2/P3	P1
影响范围	受影响用户/功能	支付下单成功率下降 12%
时间线	发现—定位—恢复	14:02 告警 / 14:18 定位 / 14:35 恢复
根因	直接原因与深层原因	连接池配置过小
改进项	负责人与截止日期	扩容连接池，张三，本周五

模板分为全局模板（全站可用）和空间模板（仅本空间可用）。创建入口：空间设置 → 内容工具 → 模板 → 新建模板。

五、宏：让页面从“静态文本”变成“动态组件”

宏（Macro）是嵌入页面的功能块，是 Confluence 页面能力扩展的核心。常用宏包括：

信息/警告/提示宏：用颜色块突出注意事项。
状态宏：显示“进行中/已完成/已阻塞”等彩色标签。
目录宏：自动根据标题层级生成页面内目录。
Jira 问题宏：在页面中直接嵌入 Jira 需求或缺陷列表，实时同步状态。
附件宏：列出当前页面的附件。
子页面宏：自动列出当前页面的所有子页面。

宏的价值在于减少手工维护。例如在“迭代发布说明”页面中插入 Jira 问题宏，筛选条件设为 project = PAYGW AND fixVersion = "v2.3.0"，则每次 Jira 中问题状态变化，Confluence 页面刷新后自动更新，无需人工复制粘贴。

六、权限：空间权限与页面限制的双层控制

Confluence 权限分为两层：

空间权限：决定“谁能进入这个空间、能做什么”。典型角色包括管理员、编辑者、查看者。空间权限在“空间设置 → 权限”中配置，可对用户组或单个用户授权。
页面限制：在空间权限基础上进一步收窄。例如整个空间对研发组可编辑，但“薪酬方案”页面仅对 HR 组可见。页面限制通过页面右上角“限制”按钮设置，可添加“仅查看”或“可编辑”的用户/组。

注意：页面限制只能收窄、不能放宽空间权限。如果用户没有空间查看权限，即使被加入某页面的查看列表，也无法访问该页面。

七、协作机制：评论、@提及、共享与通知

Confluence 的协作能力体现在四个动作上：

行内评论：选中一段文字后评论，讨论锚定在具体内容上，避免“评论与正文脱节”。
@提及：输入 @张三，被提及者会收到通知，适合分配任务或请求确认。
共享：可将页面链接分享给未加入空间的同事，但对方能否打开仍受权限约束。
通知：关注页面或空间后，内容变更会推送邮件或站内通知。

八、七个概念的关系全景

下面这张图把空间、页面、博客、模板、宏、权限、协作机制放在同一张关系图中，帮助建立整体认知：

九、概念之间的判断逻辑

在实际使用中，可以用以下顺序快速判断该用哪个概念：

内容属于哪个团队/项目？→ 决定放在哪个空间。
内容需要固定位置长期引用吗？→ 是则建页面，否则发博客。
同类内容会反复创建吗？→ 是则先建模板。
页面中需要动态数据或自动列表吗？→ 是则插入宏。
谁可以看、谁可以改？→ 先配空间权限，再按需加页面限制。
需要多人讨论和确认吗？→ 用行内评论和 @提及，并关注页面接收变更通知。

一个常见误区：把 Confluence 当成“文件柜”，只上传附件不写页面。附件无法被搜索、无法被评论、无法形成版本对比。正确做法是把关键结论写成页面正文，附件作为补充材料挂在页面下方。

掌握这七个概念后，后续创建空间、编写页面、配置权限、使用模板和宏时，就能清楚每一步在整体结构中处于什么位置、影响什么范围。这是从“会用 Confluence”走向“用好 Confluence”的分水岭。