Git-SVN 终极指南：连接 Git 和 Subversion

在软件开发的世界里，版本控制系统是不可或缺的工具。Git 作为分布式版本控制的佼佼者，以其灵活性、速度和强大的分支管理能力而广受欢迎。然而，在某些情况下，你可能仍然需要与使用 Subversion (SVN) 作为中央版本控制系统的团队或项目进行协作。这时，Git-SVN 就成为了连接这两个世界的桥梁。

Git-SVN 是 Git 的一个双向桥接工具，它允许你将 Git 仓库作为 Subversion 客户端使用。这意味着你可以在本地享受 Git 的所有优点（本地提交、快速分支、离线工作等），同时与远程的 Subversion 仓库保持同步。本文将深入探讨 Git-SVN 的各个方面，包括其工作原理、安装配置、常用命令、高级用法以及常见问题解答，旨在为你提供一份全面的 Git-SVN 使用指南。

1. Git-SVN 的工作原理

理解 Git-SVN 的工作原理是高效使用它的关键。Git-SVN 的核心在于它模拟了一个 Subversion 客户端的行为。当你使用 git svn clone 命令克隆一个 Subversion 仓库时，Git-SVN 会执行以下操作：

1. 遍历 Subversion 历史: Git-SVN 会从 Subversion 仓库的根目录开始，逐个读取每一个提交（revision）。

2. 转换提交信息: 对于每一个 Subversion 提交，Git-SVN 会将其转换为 Git 提交。这包括：

   • 将 Subversion 的提交者信息映射到 Git 的作者和提交者信息。
   • 将 Subversion 的提交消息转换为 Git 的提交消息。
   • 将 Subversion 的修订号（revision number）作为一个特殊的 Git 注释存储起来（通常在 git-svn-id 中）。

3. 构建 Git 历史: Git-SVN 将转换后的 Git 提交按照 Subversion 的修订号顺序排列，构建出一个线性的 Git 历史。这使得 Git 历史与 Subversion 历史保持一一对应。

4. 创建 Git 分支: Git-SVN 会为 Subversion 仓库中的每一个分支和标签创建相应的 Git 分支。

当你使用 git svn rebase 或 git svn dcommit 命令与 Subversion 仓库交互时，Git-SVN 会执行以下操作：

• git svn rebase (类似于 svn update):

  1. 从 Subversion 仓库获取最新的提交。
  2. 将这些提交转换为 Git 提交，并添加到 Git 历史中。
  3. 将你本地的 Git 提交变基（rebase）到最新的 Subversion 提交之上。

• git svn dcommit (类似于 svn commit):

  1. 将你本地的 Git 提交逐个转换为 Subversion 提交。
  2. 将这些 Subversion 提交提交到 Subversion 仓库。
  3. 更新 Git 历史，使其与 Subversion 仓库保持一致。

需要注意的是，由于 Git 和 Subversion 在版本控制模型上的根本差异，Git-SVN 在进行转换时需要进行一些妥协。例如，Git 的分支是轻量级的、本地的，而 Subversion 的分支通常是在服务器上创建的目录。Git-SVN 通过在 Git 中创建与 Subversion 分支相对应的本地分支来模拟 Subversion 的分支模型。

2. 安装与配置 Git-SVN

在大多数 Git 发行版中，Git-SVN 通常已经作为标准组件包含在内。你可以通过在终端中运行 git svn --version 来检查是否已安装。如果未安装，你可以通过系统的包管理器进行安装：

• Debian/Ubuntu:

bash
sudo apt-get install git-svn

• Fedora/CentOS/RHEL:

bash
sudo yum install git-svn

• macOS (Homebrew):

bash
brew install git

• Windows:
  通常情况下，Git for Windows 已经包含了 Git-SVN。

安装完成后，你可能需要进行一些全局配置，以便更好地使用 Git-SVN。这些配置通常存储在你的 Git 配置文件中（~/.gitconfig 或 %USERPROFILE%\.gitconfig）。

以下是一些常用的配置选项：

• svn-remote.<remote-name>.url: 指定 Subversion 仓库的 URL。
• svn-remote.<remote-name>.fetch: 指定 Subversion 仓库中的哪些目录映射到 Git 的哪些分支。
• svn-remote.<remote-name>.branches: 指定哪些Subversion仓库目录映射到 Git的分支
• svn-remote.<remote-name>.tags: 指定哪些Subversion仓库目录映射到 Git的tags
• svn.authorsfile: 指定一个作者映射文件，用于将 Subversion 用户名映射到 Git 的用户名和邮箱。

例如，一个典型的配置可能如下所示：

[svn-remote "svn"]
url = https://svn.example.com/project
fetch = trunk:refs/remotes/origin/trunk
branches = branches/*:refs/remotes/origin/*
tags = tags/*:refs/remotes/origin/tags/*
[svn]
authorsfile = authors.txt

在这个例子中：

• svn-remote "svn" 定义了一个名为 "svn" 的远程 Subversion 仓库。
• url 指定了 Subversion 仓库的 URL。
• fetch 将 Subversion 的 trunk 目录映射到 Git 的 refs/remotes/origin/trunk 分支。
• branches 将 Subversion 的 branches 目录下的所有子目录映射到 Git 的 refs/remotes/origin/* 分支。
• tags 将 Subversion 的 tags 目录下的所有子目录映射到 Git 的 refs/remotes/origin/tags/* 分支。
• authorsfile 指定了一个名为 authors.txt 的作者映射文件。

authors.txt 文件的内容可能如下所示：

svn_user1 = Git User1 <[email protected]>
svn_user2 = Git User2 <[email protected]>

3. Git-SVN 常用命令

Git-SVN 提供了一系列命令，用于与 Subversion 仓库进行交互。以下是一些最常用的命令：

• git svn clone: 克隆一个 Subversion 仓库。这是你开始使用 Git-SVN 的第一步。

  bash
git svn clone <svn_repo_url> [options]

  常用选项：

  • -s 或 --stdlayout: 如果 Subversion 仓库遵循标准布局（trunk、branches、tags），可以使用此选项。
  • -T <trunk_path>: 指定 trunk 的路径。
  • -b <branches_path>: 指定 branches 的路径。
  • -t <tags_path>: 指定 tags 的路径。
  • --prefix <prefix>: 为远程分支添加前缀，避免与本地分支冲突。 建议添加origin/

  例如：

  bash
git svn clone -s https://svn.example.com/project --prefix origin/

• git svn fetch: 从 Subversion 仓库获取最新的提交，但不进行合并或变基。

  bash
git svn fetch

• git svn rebase: 从 Subversion 仓库获取最新的提交，并将你本地的 Git 提交变基到最新的 Subversion 提交之上。这相当于 svn update。

  bash
git svn rebase

• git svn dcommit: 将你本地的 Git 提交逐个转换为 Subversion 提交，并提交到 Subversion 仓库。这相当于 svn commit。

  bash
git svn dcommit
  重要提示： 在执行 dcommit 之前，务必先执行 rebase，确保你的本地提交是基于 Subversion 仓库的最新提交。

• git svn branch <branch_name>: 基于当前的 Git 提交在 Subversion 仓库中创建一个新的分支。

  bash
git svn branch new_feature

• git svn tag <tag_name>: 基于当前的 Git 提交在 Subversion 仓库中创建一个新的标签。

  bash
git svn tag v1.0

• git svn info: 显示当前 Git 仓库对应的 Subversion 仓库的信息。

  bash
git svn info

• git svn log: 显示 Subversion 仓库的提交历史。

  bash
git svn log

4. Git-SVN 高级用法

除了上述常用命令外，Git-SVN 还提供了一些高级用法，可以帮助你更灵活地管理 Subversion 仓库：

• 处理 Subversion 外部链接 (svn:externals):

  Subversion 的 svn:externals 属性允许你将其他 Subversion 仓库中的目录或文件包含到当前仓库中。Git-SVN 可以处理这些外部链接，但默认情况下是禁用的。要启用此功能，你需要在 Git 配置文件中设置 svn.ignore-externals 为 false：

  [svn]
ignore-externals = false

  启用后，Git-SVN 会在 fetch 或 rebase 时自动处理外部链接。

• 处理 Subversion 属性 (svn:propset):

  Subversion 允许你为文件和目录设置属性。Git-SVN 可以将这些属性存储在 Git 的元数据中。你可以使用 git svn propget、git svn proplist 和 git svn propset 命令来管理 Subversion 属性。

• 迁移 Subversion 仓库到 Git:

  如果你希望将一个 Subversion 仓库完全迁移到 Git，Git-SVN 可以作为迁移工具。你可以使用 git svn clone 克隆整个 Subversion 历史，然后将这个 Git 仓库推送到一个新的 Git 服务器。

  但是，对于大型的、历史悠久的 Subversion 仓库，git svn clone 可能会非常耗时。在这种情况下，你可能需要考虑使用其他专门的迁移工具，例如 SubGit 或 svn2git。

• 使用多个 Subversion 远程仓库:

  Git-SVN 允许你配置多个 Subversion 远程仓库。这在处理跨多个 Subversion 仓库的项目时非常有用。你可以在 Git 配置文件中为每个 Subversion 仓库定义一个 svn-remote 部分。

• 处理 Subversion 的合并信息（Mergeinfo）：

Subversion 使用 svn:mergeinfo 属性来跟踪分支合并的信息。Git 没有类似的概念。因此 当使用 git svn dcommit提交一个合并提交到 Subversion 时，你需要先将这次合并的提交先rebase到一个非合并的提交上，然后再执行dcommit， 否则会失败。

5. 常见问题解答

在使用 Git-SVN 的过程中，你可能会遇到一些问题。以下是一些常见问题的解答：

• git svn clone 非常慢:

  对于大型的、历史悠久的 Subversion 仓库，git svn clone 可能会非常耗时，因为它需要遍历 Subversion 的每一个提交。你可以尝试使用 --revision 选项来指定一个起始修订号，只克隆部分历史。

• git svn dcommit 失败:

  dcommit 失败的常见原因包括：
  * 未执行 rebase：在 dcommit 之前，务必先执行 rebase。
  * 冲突：如果 Subversion 仓库中有其他人提交了与你本地提交冲突的更改，dcommit 会失败。你需要先解决冲突。
  * 权限问题：你可能没有足够的权限向 Subversion 仓库提交更改。
  * 合并提交： Git中的合并提交在Subversion中无法完美体现，需要rebase到一个非合并提交上。

• Git 历史与 Subversion 历史不一致:

  Git-SVN 会尽力保持 Git 历史与 Subversion 历史的一致性，但由于两者模型的差异，可能会出现一些不一致的情况。例如，Subversion 的空提交在 Git 中可能不会显示。

• 如何处理 Subversion 的二进制文件:

  Git 更适合处理文本文件，对于二进制文件，Git 的存储效率可能不如 Subversion。如果你需要频繁地修改大型二进制文件，使用 Git-SVN 可能不是最佳选择。

• 如何回滚错误的dcommit

因为dcommit之后，本地的提交记录会发生变化（commit hash变化），因此如果某次dcommit有问题，希望回滚，则需要先在SVN服务端进行回滚操作，然后本地使用git svn fetch 和git svn rebase -l来同步SVN上的变更，并更新本地Git历史。

6. 走向纯粹的 Git

Git-SVN 是一个强大的工具，它让你能够在享受 Git 带来的便利的同时，与 Subversion 仓库保持同步。 尽管如此， 长期来看，如果条件允许，完全迁移到纯粹的 Git 环境通常是更优的选择。 Git 提供了更现代、更灵活、更强大的版本控制体验。 Git-SVN 可以作为过渡阶段的解决方案，帮助你逐步将团队和项目迁移到 Git。 如果你正在考虑进行迁移， 可以详细评估现有工作流程，制定迁移计划， 并充分利用 Git 社区提供的丰富资源和工具。