为什么要把SVN搬到Git上
很多团队早期习惯用SVN做集中式版本控制，项目初期确实简单直观。但随着代码量增加和协同开发变复杂，SVN的分支切换慢、历史回退麻烦、离线开发受限等问题就暴露出来了。Git作为分布式版本管理的行业标准，能彻底解决这些痛点，让并行开发更顺畅，发布流程也更稳定。把老项目迁到Git上，其实是给团队协作提速的必要动作，后续接入CI流水线也方便得多。
迁移前的准备工作
动手之前先把环境搭好。确保电脑上已经安装过Git，并且支持SVN插件。Windows用户可以直接装完整的Git Bash或图形化客户端，Mac和Linux用户通过命令行输入git svn即可确认是否可用。接着拿到SVN仓库的真实地址，最好准备一个有读写权限的账号。新建一个空文件夹作为临时工作区，不要直接在原来的SVN目录里折腾，避免意外损坏旧数据。如果仓库特别大，建议先在本地拉一次全量日志，大概估算下耗时，心里有个底。
核心步骤一生成Authors映射文件
这是迁移最关键的一步。SVN里记录的是用户名，而Git要求每个提交都必须有邮箱和真实姓名。如果跳过这一步，后面所有代码提交的作者都会变成乱码或者unknown。在命令行进入临时文件夹，先执行一次快速抓取操作来提取历史记录中的用户名。可以用一行命令导出XML格式的日志，然后过滤出author字段去重保存为txt文件。拿到名单后手动打开编辑，按照固定格式填写。每一行对应一个开发者，左边写SVN里的原名，中间用等号连接，右边写上Git需要的实名和邮箱。格式一定要严格对齐，哪怕错一个空格都会导致映射失败。整理完保存为authors.txt备用。
核心步骤二执行迁移命令
环境配齐后就可以正式跑命令了。在终端中输入git svn clone，后面跟上刚才准备好的映射文件路径，再指定SVN仓库地址和目标文件夹名字。加上no metadata参数可以过滤掉SVN自带的私有属性，让Git库保持干净。命令敲下去后会开始逐条下载历史提交，进度条会一直跑，期间千万不要中断。遇到网络波动时它会自动重试，耐心等待直到提示克隆完成。整个过程根据项目体量可能几分钟也可能几小时，喝杯咖啡等着就行。完成后进入新生成的文件夹，输入git log随便翻几条，核对一下作者名和提交时间是不是都正常显示。
核心步骤三验证与后续操作
数据搬过来只是第一步，接下来要处理分支和标签的转换问题。SVN习惯把分支和标签放在trunk和branches目录下，而Git把它们当成独立对象管理。迁移工具通常会自动识别并转换，但为了保险起见，最好在Git客户端里检查一下refs/heads和refs/tags目录。确认无误后，在远程平台如GitHub或GitLab上创建一个空白仓库，把地址复制下来。回到本地终端输入remote add origin新地址，然后push master到云端。这时候整个项目就已经在Git上了。最后记得召开内部同步会，更新团队的代码规范，把IDE里的版本控制插件切换到Git模式，以后日常开发直接走Pull Request流程，彻底告别旧的SVN工作流。
