git克隆代码保留提交记录，从源仓库迁移到新仓库地址

在 Git 中迁移代码并保留完整的提交历史记录，可以通过以下几种方法实现，具体选择取决于源仓库和目标仓库的访问权限、是否需要重写历史（如修改提交信息或作者信息）等因素。以下是详细的操作步骤：

---

方法 1：直接推送（适用于同平台或可访问的远程仓库）

适用场景：源仓库和目标仓库均可通过 Git 协议（如 HTTPS/SSH）访问，且无需修改历史记录。

步骤

1. 将本地仓库与源仓库关联（如果尚未克隆）：

   bash

   	git clone <源仓库URL> # 克隆源仓库到本地
   	cd <仓库目录>

2. 添加目标仓库作为远程仓库：

   bash

   git remote add target <目标仓库URL> # 例如 GitHub/GitLab/Gitee 的仓库地址

3. 推送所有分支和标签到目标仓库：

   bash

   	git push --all target # 推送所有分支
   	git push --tags target # 推送所有标签

4. 验证：

   • 在目标仓库中检查分支和提交历史是否完整。

---

方法 2：镜像克隆（完整复制包括远程分支）

适用场景：需要完全复制源仓库的所有内容（包括远程分支、标签等），通常用于备份或迁移到不可写的仓库（如从 GitHub 迁移到自建 GitLab）。

步骤

1. 使用 --mirror 参数克隆源仓库：

   bash

   	git clone --mirror <源仓库URL> # 镜像克隆（仅克隆 .git 目录，不包含工作区）
   	cd <镜像目录> # 进入克隆的 .git 目录

2. 修改远程仓库地址为目标仓库：

   bash

   git remote set-url origin <目标仓库URL>

3. 推送所有内容到目标仓库：

   bash

   git push --mirror # 推送所有分支、标签、远程引用等

4. 验证：

   • 目标仓库将与源仓库完全一致（包括所有分支、标签和历史记录）。

---

方法 3：使用 git bundle（适用于离线迁移或无网络访问）

适用场景：源仓库和目标仓库之间无法直接通过网络访问（如内网到外网迁移），或需要打包历史记录供后续导入。

步骤

1. 在源仓库所在机器上创建 Git 包：

   bash

   	git bundle create <bundle文件名>.bundle --all # 打包所有分支和标签
   	# 或指定分支范围：
   	# git bundle create <bundle文件名>.bundle <源分支>..<目标分支>

2. 将 .bundle 文件传输到目标机器（如通过 USB、SCP 等）。

3. 在目标机器上克隆或拉取包：

   • 克隆新仓库：
     bash

     	git clone <bundle文件名>.bundle <目标目录>
     	cd <目标目录>

   • 或拉取到现有仓库：
     bash

     git pull <bundle文件名>.bundle <分支名>

4. 验证：

   • 检查提交历史是否完整。

---

方法 4：修改历史后迁移（如重写作者信息、提交信息）

适用场景：需要修改提交历史（如修正错误的作者邮箱、合并提交等）后再迁移。

步骤

1. 克隆源仓库并修改历史：
   bash

   	git clone <源仓库URL>
   	cd <仓库目录>

   • 使用 git filter-repo、git rebase 或 git filter-branch 修改历史（例如修正作者信息）：
     bash

     	# 示例：修正所有提交的作者信息
     	git filter-repo --author-name "旧名字" --author-email "旧邮箱@example.com" --author-name "新名字" --author-email "新邮箱@example.com"

2. 推送修改后的历史到目标仓库：
   bash

   	git remote add target <目标仓库URL>
   	git push --all target
   	git push --tags target

---

常见问题解决

1. 权限错误

• 确保对目标仓库有写入权限（如 SSH 密钥已配置，或 HTTPS 用户名/密码正确）。
• 如果是 GitHub/GitLab，检查是否生成了 Personal Access Token 并用于认证。

2. 历史记录不完整

• 使用 git log --all --oneline 检查本地是否包含所有分支的历史。
• 如果某些分支未推送，手动推送：
  bash

  git push target <分支名>

3. 大文件问题

• 如果仓库包含大文件（如超过 100MB），需配置 Git LFS 或分批迁移。

4. 迁移后分支混乱

• 在目标仓库中删除错误的分支并重新推送：
  bash

  	git push target --delete <错误分支名>
  	git push target <正确分支名>

---

总结

方法	适用场景	命令示例
直接推送	同平台迁移，无需修改历史	git push --all target + git push --tags target
镜像克隆	完全复制源仓库（包括远程分支）	git clone --mirror + git push --mirror
Git Bundle	离线迁移或无网络访问	git bundle create + git clone/pull <bundle文件>
修改历史后迁移	需要重写作者信息、合并提交等	git filter-repo + git push --all target

推荐流程：

1. 优先尝试 直接推送（简单快捷）。
2. 如果需要完整复制（包括远程分支），使用 镜像克隆。
3. 离线环境使用 Git Bundle。
4. 需要修改历史时，结合 git filter-repo 或 git rebase 后再推送。