使用文档
将 Confluence 页面与参考页面对比
在页面变化宏中选择与其他页面对比,即可展示当前页面与标准、模板或相关文档之间的差异。读者打开页面后就能查看,无需自行选择两侧内容。
本例将 Release readiness standard(发布准备标准)作为参考页面,将 Aurora release readiness(Aurora 发布准备)作为当前页面。标准要求两名评审人,Aurora 要求三名,并增加提前 24 小时通知的要求。对比会突出这些差异,但不会判断差异是否合规,也不会修改任何一侧的文档。
配置参考页面
- 编辑需要展示差异的页面,本例为 Aurora release readiness。
- 插入页面变化(Page changes)宏;已有宏则选中后点击编辑。参见插入宏。
- 选择与其他页面对比(Compare with another page)。
- 在**参考页面(Before)**中搜索标题、粘贴 Confluence 页面链接或输入内容 ID,然后选中对应结果。
- 为参考页面选择跟随最新版本(Follow latest)或固定版本(Fixed version)。
- 如需打开页面就显示完整差异,勾选默认在页面上展开完整对比。
- 点击保存(Save),然后发布或更新 Confluence 页面。

宏设置中不需要再选择当前页面。参考页面必须是同一 Confluence 站点中的另一份受支持内容,可以是普通页面、博客文章或实时文档;读者具有访问权限时,也可以选择其他空间中的内容。
跟随更新或固定版本
| 参考页面设置 | 实际行为 | 适用场景 |
|---|---|---|
| 跟随最新版本 | 每次加载页面时,获取参考页面当时可用的最新版本。 | 持续检查与维护中的标准之间的差异。 |
| 固定版本 | 使用保存设置时确定的具体版本号。 | 按某次发布或里程碑的标准进行评审。 |
在固定版本模式下,即使选择的是最新版本,保存时也会固定为具体版本号。例如参考页面当前为 v1,保存后就固定使用 v1,后续发布 v2 不会自动改变它。需要持续跟随更新时,应选择跟随最新版本。
当前页面使用卡片加载时可读取的最新已发布或已保存内容。展开卡片或打开完整对比会沿用卡片已确定的版本,不会再次检查更新。需要获取新的一组版本时,重新加载 Confluence 页面。实时文档的每次保存不一定都会形成独立历史版本。
阅读差异
卡片展示参考页面名称、版本策略、当前页面名称和差异数量。点击展开在页面内阅读,或点击查看差异(View differences)打开完整对比。

选择合并视图(Unified)在一份内容中阅读,或选择并排视图(Side by side)查看两个阅读区域。使用上一处变化和下一处变化逐项检查;并排视图中的同步滚动可让两侧保持阅读位置对齐。
对比覆盖两侧的整篇正文。页面变化宏自身及其设置不计入差异;存在这些宏时,结果会显示相应说明。其他受支持的页面内容仍参与对比。
未发现差异表示两侧内容已成功完成对比,读者仍可打开结果。参考页面或版本无法访问时,会显示不可用提示,不会显示为零差异。
交换对比方向
默认方向为参考页面 → 当前页面。点击两个页面标题之间的箭头按钮交换对比前和对比后页面(Swap before and after pages),可反向阅读同一组内容;新增和删除也会随方向反转。
- 在页面内展开的宏中,合并视图和并排视图都支持交换。
- 在完整对比弹窗中,切换到并排视图后才能看到交换按钮。
- 交换保留已经确定的版本,不会获取更新版本,也不会修改保存的参考页面。
- 切换阅读视图会保留当前方向;收起后再次展开,则恢复宏原来的方向。
点击查看差异时,完整弹窗从宏原来的方向开始,即使页面内的结果已经反向。弹窗中的恢复宏比较范围可以还原临时调整的版本和方向;关闭后重新打开也会恢复原始组合。参见临时检查其他版本。
分享或保存评审结果
点击查看差异打开完整弹窗后,才能使用版本选择、分享和导出 → PDF 导出。分享链接保存实际版本号和阅读模式,因此不会随着“跟随最新版本”而持续变化。接收者仍需具备两侧页面的访问权限。
页面内的结果不提供版本选择、分享或导出控件。Confluence 自身的页面导出也不是一份保存下来的交互式对比。完整工作区的操作参见阅读对比结果。
处理不可用的对比
| 遇到的情况 | 处理方法 |
|---|---|
| 无法打开参考页面 | 先在 Confluence 中直接访问它;请页面所有者提供必要权限,或改选其他参考页面。 |
| 固定的参考版本不可用 | 编辑宏并选择可访问的版本;宏不会自动替换原来选择的版本。 |
| 参考页面与当前页面相同 | 改选其他页面;比较同一页面的历史版本时,使用固定基准模式。 |
| 复制页面后仍使用原来的参考页面 | 这是预期行为:参考页面保留,“本页面”变成复制后的新页面。复制后应检查设置。 |
| 将宏复制到参考页面自身后无效 | 在目标页面中重新选择其他参考页面。 |
| 需要比较另外两个页面 | 从应用主页选择两侧内容;宏始终将放置它的页面作为 After。 |