如何将GitLab项目下的Wiki迁移至ADO Git Wiki仓库

做GitLab到ADO Git Repo全量制品迁移时，公开渠道能找到的Wiki专项迁移参考资料非常少，实测走通的可落地方法如下：

核心原理提前说：GitLab 项目 Wiki 不是存在数据库里的零散页面，本身就是一个独立的Git版本仓库，所有页面内容、附件、编辑提交历史都存在这个仓库里，根本不需要爬页面、逐篇导出Markdown这种低效操作。

前置准备 #

• 持有源GitLab项目的Reporter及以上权限，可拉取Wiki仓库
• 持有目标ADO项目的Wiki编辑、Git仓库推送权限
• 本地已安装可用的Git命令行环境

具体操作步骤 #

1. 拉取GitLab Wiki全量镜像
   打开GitLab目标项目的左侧栏「Wiki」入口，点击页面右上角的「Clone repository」获取Wiki仓库的克隆地址，本地执行全量镜像克隆，不要加浅克隆参数避免丢历史：

   git clone --mirror <GitLab Wiki仓库克隆地址> gitlab-wiki-temp
   

2. 准备ADO端Wiki接收仓库
   打开目标ADO项目，左侧导航切到「Wiki」：
   • 如果项目还没创建过Wiki，直接点「Create Wiki」，系统会自动生成一个后缀为.wiki的专用Git仓库托管Wiki内容
   • 如果项目已有Wiki，点页面右上角三个点的更多菜单，选「Clone wiki」拿到对应仓库的克隆地址
3. 全量推送Wiki内容到ADO
   进入本地的镜像仓库目录，添加ADO Wiki仓库为远程源，全量推送所有分支、标签和提交记录：

   cd gitlab-wiki-temp
   git remote add adowiki <ADO Wiki仓库克隆地址>
   git push adowiki --all
   git push adowiki --tags
   

4. 迁移后校验
   推送完成后回到ADO Wiki页面做常规检查：
   • 页面目录层级、侧边栏导航是否和GitLab侧一致
   • 页面内相对路径引用的图片、附件是否能正常加载
   • 页面的提交历史、版本记录是否完整保留
     小提示：两边的Markdown语法95%以上是兼容的，比如通用目录标签[[_TOC_]]可以直接识别，只有极个别GitLab专属的快捷引用语法需要手动微调，工作量极小。

特殊场景适配 #

• 不需要保留编辑历史，只迁当前最新内容：直接普通克隆GitLab Wiki仓库，删除根目录下的.git文件夹，再克隆ADO Wiki仓库，把所有Wiki文件拷进去提交推送即可，操作速度更快
• Wiki包含超大附件：ADO Git仓库单文件大小上限为100MB，超过的附件提前迁移到ADO制品库或者通用附件存储，替换页面内对应链接后再推送即可

内容的提问来源于stack exchange，提问作者Tim