Git-SVN 抛弃：历史保留的SVN到Git迁移指南

项目介绍

Git-SVN 抛弃 是一个专为希望从Subversion（SVN）迁移到Git的开发者设计的历史保留迁移工具。该项目利用 git-svn 功能来实现平滑过渡，确保在转换过程中保持完整的提交历史，这对于保持代码库的完整性和追溯性至关重要。它由@nothingmuch开发并采用MIT许可协议发布。

项目快速启动

安装

首先，你需要安装 git-svn-abandon 工具。如果你是Homebrew的用户，在终端中运行以下命令：

brew install git-svn-abandon

如果不在Homebrew环境下，你可能需要手动下载源码并编译或通过其他包管理器完成安装。

迁移步骤

1. 克隆SVN仓库，假设你的SVN仓库地址是https://example.com/repo/svnrepo, 使用git svn clone命令，并指定适当的分支前缀：

   git svn clone --prefix svn https://example.com/repo/svnrepo my-git-repo
   

2. 修正引用，进到新创建的Git仓库目录并执行脚本修复SVN的引用：

   cd my-git-repo
   git svn-abandon-fix-refs
   

3. 处理合并提交（如有必要），创建或编辑git/info/grafts文件来处理SVN中的合并提交。

4. 清理，进行最后的清理工作以确保转换后的仓库干净无污染：

   git svn-abandon-cleanup
   

此时，你应该有一个干净的Git仓库，包含了所有SVN的历史，且所有的SVN标签被转换为Git的注解标签。

应用案例和最佳实践

在企业级代码库迁移场景中，Git-SVN 抛弃特别有用。当团队决定从SVN迁移至Git时，它可以保证迁移过程无损历史，这对于后续的代码审查、合规审计极其重要。最佳实践包括：

• 在开始迁移之前备份SVN仓库。
• 对大型仓库，先在一个小型副本上测试迁移流程。
• 确保正确处理了SVN中的复杂合并逻辑，以免丢失历史细节。
• 迁移完成后，通知团队成员停止对旧SVN仓库的更新，并开始使用新的Git仓库。

典型生态项目

虽然Git-SVN 抛弃本身就是一个用于特定目的的工具，其生态系统并不直接关联到其他特定的开源项目。然而，类似的工具如Sam Vilain的带有svn-merge-attrs分支的git-svn，或是Snerp Vortex（rcaputo/snerp-vortex）提供了不同的解决方案和特性，这些工具共同构建了一个围绕版本控制系统迁移的强大生态，支持开发者根据具体需求选择最适合自己的工具。

---

此指南旨在提供简明扼要的迁移指导，实践过程中应参考最新的官方文档和社区经验分享，以获得最佳结果。