本文档描述了 Subversion 1.4。如果您使用的是更新版本的 Subversion,我们强烈建议您访问 https://svnbook.subversion.org.cn/ 并查阅适合您 Subversion 版本的书籍。

分支维护

您可能已经注意到 Subversion 非常灵活。因为它使用相同的底层机制(目录复制)实现分支和标签,并且分支和标签出现在正常的系统空间中,许多人发现 Subversion 令人望而生畏。它几乎 灵活了。在本节中,我们将提供一些关于如何随着时间的推移安排和管理数据的建议。

仓库布局

有一些标准的推荐方式来组织仓库。大多数人创建一个 trunk 目录来保存开发的“主线”,一个 branches 目录来保存分支副本,以及一个 tags 目录来保存标签副本。如果仓库只保存一个项目,那么人们通常会创建这些顶级目录

/trunk
/branches
/tags

如果仓库包含多个项目,管理员通常会按项目索引它们的布局(有关“项目根目录”的更多信息,请参阅 名为“规划您的仓库组织”的部分)。

/paint/trunk
/paint/branches
/paint/tags
/calc/trunk
/calc/branches
/calc/tags

当然,您可以随意忽略这些常用布局。您可以创建任何类型的变体,只要适合您或您的团队。请记住,无论您选择什么,都不是永久的承诺。您可以随时重新组织仓库。由于分支和标签是普通的目录,svn move 命令可以按照您的意愿移动或重命名它们。从一种布局切换到另一种布局只是执行一系列服务器端移动操作的问题;如果您不喜欢仓库中的组织方式,只需调整目录即可。

但是请记住,虽然移动目录很容易,但您也需要考虑用户的感受。您的调整可能会让拥有现有工作副本的用户感到困惑。如果用户拥有某个特定仓库目录的工作副本,您的 svn move 操作可能会从最新版本中删除该路径。当用户下次运行 svn update 时,会收到一条消息,告诉他们他们的工作副本代表着一个不再存在的路径,用户将被迫 svn switch 到新位置。

数据生命周期

Subversion 模型的另一个优点是,分支和标签可以像任何其他版本化项目一样具有有限的生命周期。例如,假设您最终完成了对 calc 项目的个人分支的所有工作。在将所有更改合并回 /calc/trunk 后,您不需要再保留您的私有分支目录

$ svn delete http://svn.example.com/repos/calc/branches/my-calc-branch \
             -m "Removing obsolete branch of calc project."

Committed revision 375.

现在您的分支不见了。当然它并没有真正消失:该目录只是从 HEAD 版本中消失了,不再分散任何人的注意力。如果您使用 svn checkoutsvn switchsvn list 检查早期版本,您仍然可以看到旧的分支。

如果您浏览已删除的目录还不够,您始终可以将其恢复。在 Subversion 中恢复数据非常容易。如果您要恢复已删除的目录(或文件)到 HEAD,只需使用 svn copy -r 从旧版本中复制即可

$ svn copy -r 374 http://svn.example.com/repos/calc/branches/my-calc-branch \
                  http://svn.example.com/repos/calc/branches/my-calc-branch

Committed revision 376.

在我们的示例中,您的个人分支的寿命相对较短:您可能创建它来修复错误或实现新功能。当您的任务完成时,分支也随之结束。但是,在软件开发中,让两个“”分支并行运行很长时间也很常见。例如,假设是时候向公众发布 calc 项目的稳定版本了,并且您知道需要几个月的时间才能从软件中消除错误。您不希望人们为该项目添加新功能,但您也不想告诉所有开发人员停止编程。因此,您创建了一个软件的“稳定”分支,该分支不会发生太大变化

$ svn copy http://svn.example.com/repos/calc/trunk \
         http://svn.example.com/repos/calc/branches/stable-1.0 \
         -m "Creating stable branch of calc project."

Committed revision 377.

现在开发人员可以自由地继续将尖端(或实验性)功能添加到 /calc/trunk 中,您可以声明一个项目策略,该策略只允许将错误修复提交到 /calc/branches/stable-1.0。也就是说,随着人们继续在 trunk 上工作,人类会选择性地将错误修复移植到稳定分支中。即使稳定分支已发布,您也可能需要长时间维护该分支——也就是说,只要您继续为客户提供该版本的支持。