本文档旨在描述 Apache™ Subversion® 的 1.7.x 系列。如果您运行的是其他版本的 Subversion，强烈建议您访问 https://svnbook.subversion.org.cn/ 并查阅适合您 Subversion 版本的文档。
Subversion 跟踪树结构，而不仅仅是文件内容。这是 Subversion 被编写用来替换 CVS 的最大原因之一。
对于您这位前 CVS 用户来说，这意味着什么？
svn add 和 svn delete 命令现在可以作用于目录，就像它们作用于文件一样。同样，svn copy 和 svn move 也是如此。但是，这些命令不会在存储库中立即引起任何变化。相反，工作项只是被 “计划” 添加或删除。只有在您运行 svn commit 后，存储库才会发生变化。
目录不再是哑容器；它们像文件一样有版本号。（或者更准确地说，说 “版本 5 中的目录 foo/” 是正确的。）
让我们更详细地讨论最后一个要点。目录版本控制是一个难题；因为我们希望允许混合版本的工作副本，所以我们对滥用此模型的程度有一些限制。
从理论的角度来看，我们定义 “目录 foo 的版本 5” 表示目录条目和属性的特定集合。现在假设我们开始向 foo 添加和删除文件，然后提交。说我们仍然拥有 foo 的版本 5 将是错误的。但是，如果我们在提交后将 foo 的版本号增加，那也是错误的；可能还有其他我们尚未接收到的对 foo 的更改，因为我们尚未更新。
Subversion 通过在 .svn 区域中悄悄跟踪已提交的添加和删除来解决这个问题。当您最终运行 svn update 时，所有帐户都将在存储库中结算，并且目录的新修订号将被正确设置。 因此，只有在更新之后，才能真正安全地说您拥有目录的 “完美” 修订版。 在大多数情况下，您的工作副本将包含 “不完美” 的目录修订版。
类似地，如果您尝试对目录提交属性更改，也会出现问题。通常，提交将增加工作目录的本地修订号。但同样，这将是一个谎言，因为可能存在目录尚未拥有的添加或删除，因为尚未进行更新。 因此，除非目录是最新的，否则不允许您对目录提交属性更改。
有关目录版本控制限制的更多讨论，请参阅 名为“混合修订版工作副本”的部分。