SVN Merge命令详解：参数与用法
SVN Merge 命令详解：参数与用法
Subversion (SVN) 的 merge 命令是其版本控制系统的核心功能之一，它允许开发者将一个分支上的更改合并到另一个分支，或者将同一个分支上不同版本之间的更改合并到当前工作副本。merge 命令的强大之处在于其灵活性，可以处理各种合并场景，但也因此带来了复杂性。本文将深入探讨 svn merge 命令的各种参数、用法、最佳实践以及常见问题，帮助你全面掌握这一重要工具。
1. 合并的基础概念
在深入 svn merge 命令之前，我们需要理解几个关键概念：
- 分支 (Branch)：分支是 SVN 中从主干（trunk）或其他分支创建的独立开发线路。它允许开发者在不影响主干稳定性的情况下进行实验性开发、修复错误或添加新功能。
- 合并 (Merge)：合并是将一个分支上的更改应用到另一个分支或当前工作副本的过程。
- 工作副本 (Working Copy)：工作副本是开发者本地计算机上的 SVN 仓库的副本，开发者在工作副本中进行修改、添加和删除文件。
- 修订版本 (Revision)：SVN 仓库中的每次提交都会创建一个新的修订版本，每个修订版本都有一个唯一的编号。
- 合并信息 (Mergeinfo)：SVN 会自动跟踪哪些修订版本已经从一个分支合并到另一个分支，这些信息称为合并信息，存储在
svn:mergeinfo属性中。
2. svn merge 命令的基本语法
svn merge 命令的基本语法如下：
bash
svn merge SOURCE[@REV] TARGET_WCPATH
svn merge SOURCE1[@REV1] SOURCE2[@REV2] TARGET_WCPATH
svn merge -r M:N SOURCE[@REV] TARGET_WCPATH
让我们分解一下这些语法：
SOURCE: 指定要合并的源。这可以是一个 URL（指向 SVN 仓库中的分支或路径）或一个本地工作副本路径。[@REV]: 可选参数，指定要合并的源的特定修订版本。如果不指定，则默认合并源的 HEAD 修订版本（最新版本）。TARGET_WCPATH: 指定合并的目标，通常是你的工作副本路径。-r M:N: 指定要合并的修订版本范围。M和N是修订版本号，表示从修订版本M到N的所有更改（包括M和N）。SOURCE1[@REV1] SOURCE2[@REV2]: 这种形式用于"两差异合并" (two-URL merge),比较两个不同源路径的差异,然后将这些差异应用到目标路径. 比较少用.
3. 合并的类型
SVN 支持几种不同类型的合并，每种类型适用于不同的场景：
3.1. 合并一个修订版本范围 (Range of Revisions)
这是最常见的合并类型，它允许你将一个分支上的特定修订版本范围合并到当前工作副本。
语法：
bash
svn merge -r M:N SOURCE[@REV] TARGET_WCPATH
示例：
假设你有一个名为 feature-branch 的分支，你想将该分支上从修订版本 100 到 150 的所有更改合并到你的主干工作副本：
bash
svn merge -r 100:150 ^/branches/feature-branch .
^/branches/feature-branch：这是feature-branch分支的 URL。^符号是仓库根目录的简写。.：表示当前目录，即你的主干工作副本。
3.2. 合并两个不同的修订版本 (Two-URL Merge)
这种合并类型比较少用,比较两个不同的修订版本（或两个不同的分支）之间的差异，并将这些差异应用到你的工作副本。
语法：
bash
svn merge SOURCE1[@REV1] SOURCE2[@REV2] TARGET_WCPATH
示例：
比较 trunk 的修订版本 100 和 feature-branch 的修订版本 150 之间的差异，并将差异应用到你的工作副本：
bash
svn merge ^/trunk@100 ^/branches/feature-branch@150 .
这种合并的用处在于,它相当于用svn diff比较出差异,再用patch命令将差异应用到工作副本.
3.3. 重新整合分支 (Reintegrate a Branch)
当一个特性分支的开发完成后，你需要将其所有更改合并回主干。这就是“重新整合分支”的用武之地。 重新整合会合并特性分支自创建或者上次同步以来到HEAD版本的所有修改。
语法：
bash
svn merge --reintegrate SOURCE TARGET_WCPATH
示例：
将 feature-branch 分支的所有更改重新整合到你的主干工作副本：
```bash
确保你的工作副本是最新的
svn update
切换到主干工作副本
svn switch ^/trunk .
重新整合分支
svn merge --reintegrate ^/branches/feature-branch .
提交合并结果
svn commit -m "Reintegrate feature-branch into trunk"
```
--reintegrate 参数的注意事项：
--reintegrate只能用于将分支合并回其创建来源（通常是主干）。--reintegrate会自动处理合并信息，确保不会重复合并相同的更改。- 在 Subversion 1.8 之后,
--reintegrate选项被废弃. 推荐直接使用普通的svn merge URL来合并整个分支, SVN 会自动检测并执行 reintegrate 类型的合并。
3.4. 挑选合并 (Cherry-pick Merge)
挑选合并允许你选择性地合并一个分支上的特定修订版本，而不是整个修订版本范围。
语法：
bash
svn merge -c REV[,REV2,...] SOURCE TARGET_WCPATH
或者
bash
svn merge -r REV1:REV2 SOURCE TARGET_WCPATH
如果REV1和REV2是相邻的, 那么-r REV1:REV2等同于-c REV2
示例：
将 feature-branch 分支上的修订版本 120 和 135 合并到你的主干工作副本：
bash
svn merge -c 120,135 ^/branches/feature-branch .
3.5. 自动合并 (Automatic Merge)
SVN可以自动合并那些没有冲突的修改.
语法:
svn merge SOURCE[@REV] TARGET_WCPATH
示例:
假设我们要将feature-branch合并到主干:
```bash
确保你的工作副本是最新的
svn update
切换到主干工作副本
svn switch ^/trunk .
自动合并分支
svn merge ^/branches/feature-branch .
提交合并结果
svn commit -m "Merge feature-branch into trunk"
```
如果feature-branch和主干没有冲突,那么SVN将会自动完成合并,并更新svn:mergeinfo属性.
4. svn merge 命令的常用参数
除了上述基本参数外，svn merge 命令还提供了许多其他参数来控制合并行为：
-N或--non-recursive: 仅合并指定目录，不递归合并其子目录。--dry-run: 模拟合并操作，但不实际修改工作副本。这对于在执行合并之前预览合并结果非常有用。--force: 强制执行合并操作，即使存在本地修改或冲突。谨慎使用此参数，因为它可能导致数据丢失。--ignore-ancestry: 忽略文件的祖先关系，强制进行合并。这在处理跨分支复制和移动文件时可能有用。--accept ACTION: 指定如何处理冲突。ACTION可以是以下值之一：postpone(默认): 将冲突标记为待解决状态，留给用户手动解决。mine-conflict: 使用工作副本中的版本。theirs-conflict: 使用仓库中的版本。mine-full: 使用工作副本的完整版本,即使有冲突(和mine-conflict的区别在于,mine-conflict会保留冲突标记)theirs-full: 使用仓库的完整版本,即使有冲突.edit: 打开外部编辑器来手动解决冲突。launch: 启动外部合并工具来解决冲突。
--diff3-cmd CMD: 指定用于解决冲突的外部三向合并工具。--record-only: 只更新svn:mergeinfo属性,不实际合并.-g或--use-merge-history: 使用合并历史信息来计算要合并的更改。
5. 解决合并冲突
合并过程中最常见的问题是冲突。当两个或多个开发者对同一文件的同一部分进行了不同的修改时，就会发生冲突。SVN 无法自动解决这些冲突，需要开发者手动干预。
当发生冲突时，SVN 会在受影响的文件中插入冲突标记，如下所示：
```
<<<<<<< .mine
This is the change I made.
=======
This is the change from the other branch.
.r123
```
<<<<<<< .mine和=======之间的内容是你的工作副本中的修改。=======和>>>>>>> .r123之间的内容是来自仓库的修改（r123是修订版本号）。
解决冲突的步骤：
- 查看冲突：使用
svn status命令查看哪些文件存在冲突。 - 手动编辑：打开冲突文件，手动编辑并解决冲突。你可以选择保留你的修改、接受仓库中的修改、或者将两者结合起来。
- 删除冲突标记：解决冲突后，删除文件中的冲突标记 (
<<<<<<<,=======,>>>>>>>)。 - 标记为已解决：使用
svn resolve --accept working FILENAME命令将文件标记为已解决。 - 提交：提交你的更改。
6. 合并的最佳实践
- 频繁合并：定期将主干的更改合并到你的特性分支，以减少将来合并的复杂性。
- 保持分支简短：特性分支的生命周期应该尽可能短，以减少合并冲突的可能性。
- 提交前测试：在提交合并结果之前，务必进行充分的测试，确保合并后的代码正常工作。
- 使用
--dry-run：在执行合并之前，使用--dry-run参数预览合并结果，确保没有意外的更改。 - 理解合并信息：了解
svn:mergeinfo属性的工作原理，可以帮助你更好地跟踪合并历史。 - 使用合并工具：对于复杂的合并冲突，使用图形化的合并工具（如 TortoiseSVN、Beyond Compare、Meld 等）可以更轻松地解决冲突。
- 沟通： 与团队成员保持沟通, 了解彼此的修改, 可以有效减少冲突。
7. 常见问题及解决方案
- 树冲突 (Tree Conflicts)：当一个开发者在一个分支上删除了一个文件或目录，而另一个开发者在另一个分支上修改了同一个文件或目录时，就会发生树冲突。解决树冲突通常需要仔细检查文件或目录的历史记录，并决定是保留还是删除。
- 合并后忘记提交：合并后，必须提交更改才能将合并结果保存到仓库中。
- 重复合并：如果忘记了合并信息，可能会导致重复合并相同的更改，从而产生冲突。确保理解
svn:mergeinfo属性的工作原理，避免重复合并。 - 合并了错误的修订版本：如果不小心合并了错误的修订版本，可以使用
svn merge命令的-r参数进行回滚。例如，如果你错误地合并了修订版本 100 到 150，可以使用svn merge -r 150:100来撤销合并。
8. 总结
svn merge 命令是 SVN 中一个强大而复杂的工具。通过理解其各种参数、用法和最佳实践，你可以有效地管理分支、合并更改并解决冲突。掌握 svn merge 命令是成为一名熟练的 SVN 用户的关键。 希望这篇文章能够帮助你更好地理解和使用 SVN 的 merge 命令。