SVN Revert 命令详解：撤销本地修改与版本回溯 – wiki词典

作者： /

SVN Revert 命令详解：撤销本地修改与版本回溯

Apache Subversion (SVN) 作为一个版本控制系统，其核心功能之一就是允许开发者管理和追踪代码的变更。在开发过程中，无论是意外修改了文件，还是需要回溯到某个历史版本，revert 命令都是一个不可或缺的工具。然而，revert 命令在 SVN 中扮演的角色与一些其他版本控制系统（如 Git）中的“撤销”操作有所不同，这常常引起混淆。本文将详细解析 SVN revert 命令的两种主要用途：撤销本地修改和回溯已提交的版本。

1. SVN revert 命令概述

在 SVN 中，revert 命令主要用于撤销工作副本中的本地修改。它会将文件或目录恢复到其在工作副本中最近一次更新（svn update）或检出（svn checkout）时的状态。这意味着 revert 只能处理未提交的本地变更。

对于已经提交到版本库的变更，revert 命令并不能直接“删除”历史记录。要回溯或撤销已提交的变更，SVN 采用的是“反向合并”（reverse merge）的策略，即创建一个新的提交，其内容是抵消或撤销之前某个提交所做的更改。

2. 撤销本地修改 (Working Copy Revert)

这是 svn revert 命令最直接和常见的用法。当你对工作副本中的文件进行了修改，但尚未提交，并且决定放弃这些修改时，可以使用 revert。

2.1 工作原理

当 svn revert 针对一个文件或目录执行时，SVN 会：
1. 删除该文件或目录在工作副本中所有未提交的修改（包括内容修改、属性修改、增加/删除的文件）。
2. 将其内容和属性恢复到基准修订版本（base revision）的状态。基准修订版本是你最近一次 svn update 或 svn checkout 后，本地工作副本所基于的版本。

2.2 命令语法

bash
svn revert [PATH...]

2.3 使用示例

  • 撤销单个文件的本地修改：
    假设你修改了 src/main.c 但又不想保留这些修改。
    bash
    svn revert src/main.c
    执行后，src/main.c 会恢复到你上次 svn update 后的状态。

  • 撤销目录及其子目录下所有文件的本地修改：
    如果你在 src/ 目录下进行了多处修改，想全部放弃。
    bash
    svn revert src/
    注意： 递归撤销需要额外的选项。在较新的 SVN 版本中，svn revert DIR 会自动递归。在某些旧版本中，可能需要 -R 或 --recursive 选项。
    bash
    svn revert -R src/

  • 撤销整个工作副本的本地修改：
    当你想要清除所有未提交的修改时。
    bash
    svn revert -R .
    这会将当前目录及其所有子文件和子目录中的所有修改都撤销。

2.4 注意事项

  • svn revert 会永久性地删除未提交的本地修改，无法恢复。请在执行前确认你真的要放弃这些变更。
  • svn revert 不会影响未版本控制的文件（unversioned files）。如果你创建了新文件但尚未 svn add，revert 不会删除它们。你需要手动删除。
  • 如果文件处于冲突状态，revert 也可以用来清除冲突标记，并恢复到基准版本。

3. 回溯已提交的版本 (Reverse Merge)

当你的目标是撤销一个或多个已经提交到版本库的变更时，svn revert 命令的语义就变得有些特殊。在这种情况下，revert 实际上是执行了一次“反向合并”操作，并不会删除历史记录，而是创建了一个新的提交，这个新提交会抵消之前的错误或不想要的提交。

3.1 工作原理

SVN 的版本库是只读追加的。一旦提交，历史记录就不可更改。因此，要“撤销”一个已提交的变更，我们实际上是创建了一个新的变更，这个新变更的效果是使得版本库看起来就像那个旧的、不想要的变更从未发生过一样。

这个过程是通过 svn merge 命令配合特定选项来实现的：
1. 撤销一个特定修订版本 R：你需要将修订版本 R 之前的状态合并到 R 之后的状态，从而消除 R 所引入的更改。这通常表示为合并一个范围 R:R-1（或更常用和直观的 -c -R）。
2. 撤销一个修订版本范围 R1 到 R2：将 R1 之前的状态合并到 R2 之后的状态，从而撤销 R1 到 R2 之间的所有更改。这通常表示为合并范围 R2:R1-1（或 -c -R1,-R2）。

3.2 命令语法（通过 svn merge 实现）

“`bash

撤销单个修订版本 R

svn merge -c -R ^/path/to/repository/trunk working_copy_path

或

svn merge -c -R file:///path/to/repository/trunk@HEAD working_copy_path # 从仓库的HEAD版本反向合并R

撤销修订版本范围 R1 到 R2

svn merge -c -R1,-R2 ^/path/to/repository/trunk working_copy_path

或

svn merge -r R2:R1-1 ^/path/to/repository/trunk working_copy_path
``
**说明：**
*^/path/to/repository/trunk或file:///path/to/repository/trunk@HEAD是版本库中你正在操作的分支的 URL。在你的工作副本目录下，通常可以直接使用.表示当前目录所对应的版本库路径，即省略 URL 参数，让 SVN 自动推断。
*working_copy_path是你的工作副本路径，通常是.(当前目录)。
*-c -R是svn merge命令的一个简洁语法，表示反向合并修订版本R。
*-c -R1,-R2表示反向合并修订版本R1到R2（包含R1和R2）。
*-r R2:R1-1是一种更传统的方式，表示将版本库从R2倒退合并到R1-1` 的状态。

3.3 使用示例

假设你在 r100 提交了一个错误的功能，现在想撤销它。

  • 撤销单个已提交的修订版本 (r100)：
    首先，确保你的工作副本是干净的（没有本地修改），并且已经更新到最新。
    “`bash
    svn status
    svn update

    执行反向合并，撤销 r100 的修改

    svn merge -c -100 .

    或者如果指定了 URL，SVN 1.7+ 可以省略 URL 参数

    svn merge -c -100 ^/path/to/repo/trunk .

    检查本地修改，你会看到 r100 所做的修改现在被反向应用了

    svn status

    提交这些撤销

    svn commit -m “Revert changes made in r100: [reason for revert]”
    ``
    此时，你会得到一个新提交（例如    r101），其内容与r100` 之前的状态相同。

  • 撤销一个修订版本范围 (r98 到 r100)：
    如果你想撤销 r98、r99、r100 这三个提交所做的所有修改。
    “`bash
    svn status
    svn update

    执行反向合并，撤销 r98 到 r100 的修改

    svn merge -c -98,-100 .

    或者使用 -r 选项

    svn merge -r 100:97 .

    检查并提交

    svn status
    svn commit -m “Revert changes from r98 to r100: [reason for revert]”
    “`

3.4 注意事项

  • 这会创建一个新的提交：回溯已提交版本不会抹去历史，而是添加一个新的提交来抵消旧提交的效果。原有的提交仍然存在于版本历史中。
  • 处理冲突：如果被撤销的变更与你的工作副本中的其他本地修改或已提交的后续修改有冲突，你可能需要手动解决这些合并冲突。
  • 确保工作副本干净：在执行反向合并前，强烈建议确保你的工作副本是干净的，没有未提交的本地修改，以避免不必要的复杂性。
  • 提交回溯结果：反向合并操作只会修改你的本地工作副本。你必须执行 svn commit 才能将这些“撤销”的变更正式推送到版本库。

4. 总结

命令/操作 目标 作用 结果
svn revert [PATH] 未提交的本地修改 丢弃本地修改，恢复文件到基准版本 本地工作副本的变更被抹去
svn merge -c -R 已提交的版本回溯 创建一个新的变更，抵消指定版本的修改 在版本库中新增一个“撤销”提交

理解 svn revert 在 SVN 中的具体含义和其与 svn merge -c -R 的区别至关重要。svn revert 是你放弃本地“试验”的利器，而 svn merge -c -R 则是你修正历史“错误”而不改写历史的方式。正确地运用它们，可以帮助你更高效、安全地管理代码变更。

滚动至顶部