Git使用经验总结8-Git仓库历史记录清除

1. 引言

因为一些原因，Git 历史提交记录中会包含一些敏感信息，比如名字、邮箱、代码等等，因此就想将这些历史记录删掉。删除特定的历史提交记录还是很困难的，笔者这里的做法是干脆彻底清除 Git 历史记录，只保留当前工作目录的最新快照，重新开始一个干净的提交历史。这样做还有一个好处，就是可以改善当前的 Git 仓库体积，尤其是对于 Git 提交历史不太重要的仓库而言。

2. 方案

在进行操作之前先备份好仓库，然后进入项目目录：

cd /path/to/your/project

删除现有的 .git 目录，这会清除所有 Git 历史：

rm -rf .git

重新初始化 Git 仓库：

git init

切换到主分支：

git checkout -b main

如果有需要，设置新的用户名和邮箱：

git config user.name "your-github-username"
git config user.email "your-github-username@users.noreply.github.com"

添加所有文件并提交：

git add .
git commit -m "Initial commit (clean snapshot)"

强制推送到 GitHub，覆盖远程仓库：

# 先关联远程仓库（如果之前有）
git remote add origin https://github.com/your-username/your-repo.git

# 强制推送（--force 或 -f）
git push --force --set-upstream origin main

注意在这个流程中，也可以不一次提交所有的文件。由于网络的原因，一次提交内容太大可能会失败，可以先提交一个文件即可。等确定git push成功后就可以按照正常的步骤进行提交了。并且后续提交如果 Git 仓库的单个文件很大，可以写个脚本一个一个提交，这样更加稳妥一些。笔者使用的脚本如下：

# submit-files-one-by-one.ps1

# 获取当前目录下所有文件（不包括子目录）
$files = Get-ChildItem -Path . -File

if ($files.Count -eq 0) {
    Write-Host "⚠️  当前目录下没有文件。" -ForegroundColor Yellow
    exit 0
}

# 确保在 main 分支
git checkout main 2>$null
if ($LASTEXITCODE -ne 0) {
    Write-Host "❌ 无法切换到 main 分支。请确保已初始化仓库并创建 main 分支。" -ForegroundColor Red
    exit 1
}

# 远程仓库地址（自动获取）
$remoteUrl = git remote get-url origin 2>$null
if (-not $remoteUrl) {
    Write-Host "❌ 未设置远程仓库 origin。请先运行：git remote add origin <url>" -ForegroundColor Red
    exit 1
}

Write-Host "📤 准备逐个提交 $($files.Count) 个文件到 $remoteUrl ..." -ForegroundColor Cyan

foreach ($file in $files) {
    $filename = $file.Name
    Write-Host "`n--- 处理文件: $filename ---" -ForegroundColor Green

    # 添加单个文件
    git add -- "$filename"
    if ($LASTEXITCODE -ne 0) {
        Write-Host "⚠️  无法添加文件 $filename，跳过。" -ForegroundColor Yellow
        continue
    }

    # 提交
    $commitMessage = "Add $filename"
    git commit -m $commitMessage
    if ($LASTEXITCODE -ne 0) {
        Write-Host "⚠️  提交失败（可能无变更），跳过推送。" -ForegroundColor Yellow
        continue
    }

    # 推送 + 重试最多3次
    $retry = 3
    $success = $false
    while ($retry -gt 0 -and -not $success) {
        Write-Host "🚀 正在推送 '$filename' ... (剩余重试: $retry)" -ForegroundColor Blue
        git push origin main
        if ($LASTEXITCODE -eq 0) {
            $success = $true
            Write-Host "✅ 成功推送 '$filename'" -ForegroundColor Green
        } else {
            $retry--
            if ($retry -gt 0) {
                Write-Host "⏳ 推送失败，等待 5 秒后重试..." -ForegroundColor Yellow
                Start-Sleep -Seconds 5
            }
        }
    }

    if (-not $success) {
        Write-Host "❌ 文件 '$filename' 推送最终失败，请检查网络或手动处理。" -ForegroundColor Red
    }
}

Write-Host "`n🎉 所有文件处理完成！" -ForegroundColor Magenta

3. 其他

注意这种方式其实相当于重新初始化了 Git 仓库，如果存在另一个本地端git pull是不会成功的，因为本地历史和远程历史分叉了，无法进行合并；这时就用户需要更新仓库的话就要重新进行git clone。

其实实现本文的功能的一个更加简单的方法是在托管仓库网站（例如 GitHub ）上删除原仓库，然后重新创建一个同名仓库。不过笔者不太确定是不是真的能行，因为仓库是有人在使用的，要尽量避免地址失效。程序员应该都写过或者理解一个bug：删除对象后新建个同名的对象有时候会不成功。