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:删除对象后新建个同名的对象有时候会不成功。