Git迁移指南：轻松转移项目

keyle_xiao

Git迁移指南：轻松转移项目

当你需要将Git项目迁移到新位置、更换托管平台或彻底重置版本控制时，就很有可能需要这些知识。

一、为何需要Git迁移？

🚀 项目架构调整：将子目录拆分为独立仓库
☁️ 更换代码托管平台（GitHub → GitLab/Gitee）
🧹 清理敏感历史记录或超大文件
🆕 彻底重置项目版本历史

二、完整迁移方案（保留历史记录）

# 1. 克隆原仓库（保留所有分支和标签）
git clone --mirror https://github.com/user/old-repo.git
cd old-repo.git

# 2. 推送到新仓库
git push --mirror https://gitee.com/user/new-repo.git

# 3. 本地切换新源（适用于已有工作区）
git remote set-url origin https://new-repo-url.git
git push -u origin --all

三、纯净迁移方案（不保留历史）

# 1. 解除当前版本控制（保留文件）
rm -rf .git

# 2. 初始化新仓库
git init
git add .
git commit -m "初始提交"

# 3. 关联远程仓库
git remote add origin https://new-repo-url.git
git push -u origin master

四、高级迁移技巧

迁移指定分支

   git push new_remote local_branch:remote_branch

迁移子目录

   git filter-repo --subdirectory-filter my-subdir

清理历史大文件

   git filter-repo --strip-blobs-bigger-than 10M

五、迁移后必检项

验证分支/标签是否完整：

   git branch -a && git tag -l

检查文件完整性：

   git fsck --full

更新CI/CD配置：
- Jenkins/GitLab CI中的仓库地址
- Webhook设置

六、避坑指南

⚠️ 敏感信息处理
迁移前使用git secret scan扫描密钥/密码
推荐工具：git-secrets

⚠️ LF/CRLF问题
Windows用户迁移后执行：

git config core.autocrlf input
git reset --hard

迁移决策树
保留历史？ → 用--mirror克隆
只需最新代码？ → 移除.git后重建
需要部分历史？ → git filter-repo

七、结语

无论是平台迁移还是项目重构，掌握Git迁移技巧让你：

✅ 3分钟完成仓库转移
✅ 自由掌控版本历史
✅ 彻底解决仓库臃肿问题

记住：迁移不是结束，而是项目的新生！

实践提示：首次迁移建议在仓库副本操作
更多Git黑科技，欢迎关注【开发者精进】系列专题！

—

📢 下期预告：《Git大型仓库瘦身实战：从10GB到100MB的奇迹优化！》
点击关注不迷路，获取更多高效开发秘籍！

**## 八、批量移除Git版本控制：自动化脚本

递归删除.git的Shell脚本

#!/bin/bash

# 递归删除当前目录及子目录中的所有.git文件夹
find . -type d -name ".git" -exec rm -rf {} +

echo "✅ 已移除所有.git目录，版本控制已解除"

脚本逻辑解析

find .
- 从当前目录开始递归搜索
-type d -name ".git"
- 查找所有名为.git的目录
-exec rm -rf {} +
- 对每个找到的目录执行强制删除
- {} 表示查找到的目录路径
- + 表示批量处理（比\;更高效）

—

⚠️ 高危警告（使用前必读）

永久性删除

   - 所有提交历史、分支、标签将被不可恢复地删除！
   - 操作前请确认已备份重要版本信息

作用范围

   + 仅在当前执行目录及其子目录生效
   - 禁止在根目录(/)或家目录(~)运行！可能导致系统崩溃！

敏感操作防护

   # 安全建议：先预览将被删除的目录
   find . -type d -name ".git" | while read dir; do
     echo "[高危] 即将删除: ${dir}"
   done

—

典型使用场景

项目批量清理

   - 清理下载的示例代码库（保留代码但去除历史）
   - 迁移遗留项目到新版本控制系统

教学环境重置

   - 编程课程结束后清除学员的练习仓库
   - 技术分享前准备干净的演示环境

自动化部署

   - CI/CD流水线中准备构建环境
   - 容器镜像构建时减少层体积

—

企业级安全方案

#!/bin/bash

TARGET_DIR=$(pwd)
CONFIRM=""

# 危险操作二次确认
read -p "⚠️ 即将永久删除 ${TARGET_DIR} 下所有.git目录！确认执行？(y/N) " CONFIRM

if [[ $CONFIRM == "y" || $CONFIRM == "Y" ]]; then
  echo "[安全日志] 用户确认执行删除操作"
  find . -type d -name ".git" -exec echo "删除: {}" \; -exec rm -rf {} +
  echo "操作完成 | 删除时间: $(date)"
else
  echo "操作已取消"
fi

企业最佳实践

将脚本加入/usr/local/bin/delgit

设置alias delgit="echo '请使用安全版本'; sh /safe_path/delgit_safe.sh"

关键服务器禁用rm -rf：alias rm='rm -i'

—

终极防护建议：

- 生产环境禁止使用此脚本！
+ 测试环境操作前执行：git bundle create backup.bundle --all
```  

> 任何删除操作前，用`git bundle`创建完整备份包，可通过`git clone backup.bundle`恢复历史**