git-svn-abandon 项目下载与安装教程

1. 项目介绍

git-svn-abandon 是一个使用 git-svn 进行 SVN 到 Git 迁移的工具，它能够保留历史记录。该工具适用于希望放弃 SVN 并转向 Git 的用户，它可以清理 SVN 的历史记录，创建一个更加整洁的 Git 仓库。

2. 项目下载位置

该项目托管在 GitHub 上，项目地址为：git-svn-abandon。

3. 项目安装环境配置

在安装项目之前，确保您的系统中已经安装了 Git。以下是环境配置的步骤：

• 打开终端（或命令提示符）。
• 检查 Git 是否已安装：输入 git --version，如果返回版本信息，则表示 Git 已安装。
• 如果未安装 Git，请访问 Git 官方网站下载并安装。

![检查Git版本](/path/to/git-version-check.png)
*图 1: 检查 Git 是否安装及版本信息*

4. 项目安装方式

以下是下载和安装 git-svn-abandon 的步骤：

1. 克隆项目到本地：

   git clone https://github.com/nothingmuch/git-svn-abandon.git
   

2. 将项目中的脚本移动到系统的 $PATH 目录下，例如 /usr/local/bin，并确保它们具有执行权限：

   mv git-svn-abandon-cleanup /usr/local/bin/
   mv git-svn-abandon-fix-refs /usr/local/bin/
   mv git-svn-abandon-msg-filter /usr/local/bin/
   chmod +x /usr/local/bin/git-svn-abandon-cleanup
   chmod +x /usr/local/bin/git-svn-abandon-fix-refs
   chmod +x /usr/local/bin/git-svn-abandon-msg-filter
   

![移动并设置脚本执行权限](/path/to/move-and-set-permissions.png)
*图 2: 将脚本移动到路径并设置执行权限*

5. 项目处理脚本

当您准备好转换 SVN 仓库到 Git 时，按照以下步骤使用处理脚本：

1. 使用 git svn clone 克隆您的 SVN 仓库。
2. 进入克隆后的 Git 仓库目录。
3. 运行 git svn-abandon-fix-refs 来创建 git/info/grafts 文件，这对于处理分支之间的 SVN 合并是必要的。
4. 运行 git-svn-abandon-cleanup 清理仓库，这将删除所有除 refs/heads/* 和 tags 之外的其他引用，并将 SVN 标记转换为 Git 的注解标记。

git svn clone -s [SVN_REPOS_URL]
cd [REPO_NAME]
git svn-abandon-fix-refs
git-svn-abandon-cleanup

按照以上步骤，您将能够成功地将 SVN 仓库转换为 Git 仓库，同时保留历史记录。