BFG Repo-Cleaner,一行命令替换、删除、修改git提交记录?

1. 工具介绍

BFG Repo-Cleaner是一个使用scal语言编写的开源工具,它提供更快更简单的方式操作git提交记录,它是git filter-repo一个有效替代工具,能够更轻松的完成任务。

2. 你可以用它来做什么?

  1. 可以删除提交记录中的不再使用的一些大文件,帮助减少提交记录占用体积。
  2. 轻松移除密码、凭证和其他一些敏感的数据。

3. 什么时候用到它?

  1. 当项目需要开源,但是开发过程中提交的代码含有一些敏感信息需要删除,如密码、ip、授权码等敏感信息。
  2. git提交历史记录很多,占用空间大,需要删除过往记录中一些不在使用的文件,或者需要删除一些大文件,减少历史记录体积。

4. 如何使用?

PS:BFG Repo-Cleaner是一个可运行的jar包,所以要确保您的开发环境已经配置好了Java,否则无法使用该工具。如果您没有配置Java,请您先配置Java环境后使用。

下面说明在Windows操作系统下使用,Linux其他同理,只是进入文件夹的命令不同,执行的BFG命令是相同的

4.1 删除提交记录中的某些敏感文件

假设您的提交记录中含有test.com.pfx,pwd.properties等敏感文件,现在需要从历史记录中删除它们。

1.去BFG官网下载最先的工具Jar包。

BFG Repo-Cleaner

2.下载完成后将这个jar包复制到您到项目根目录下与.git目录同级

3.以管理员的身份打开cmd,进入项目目录。(我这里拷贝了一个项目副本做演示)

4.执行命令

项目中的敏感文件是WxUtils,里面含有appid和secret。

java -jar bfg-1.14.0.jar --delete-files WxUtils.java

5.提交修改后的历史记录

这里需要注意,如果不止一个人修改过删除的文件,那么其他人的修改记录也会被覆盖。

git push --force

最后你会发现该分支上该文件的提交记录都已经被删掉。

4.2 替换提交记录中的文本

执行命令:java -jar bfg-1.14.0.jar --replace-text replace.txt

在replace.txt文件中指定要替换的规则。

--replace-text后面的参数是规则文件的位置,我这里是直接放置于jar包同级目录下。

举一个例子说明替换的规则:

可以直接替换或者使用正则替换。

txt 复制代码
www.muhsanyu.top==>ip
regex:password: .*==>password: your password
regex:username: .*==>username: your username

第一行将所有记录中的www.muhsanyu.top字符替换为ip

第三和第四行表示使用正则,password: .*正则表示开头为password: 的所有字符串,将该字符串替换为password: your password

4.3 删除掉指定大小的文件

执行命令:java -jar bfg-1.14.0.jar --strip-blobs-bigger-than 50M

该条命令表示删除文件大小大于50m的文件,当然删除的文件是指删除提交记录中的历史文件记录。

注意4.2和4.3均需要git push --force将记录提交到远程仓库中,否则只是在本地仓库中生效。

5. 总结

如果你想要修改项目中的一些含有敏感信息的提交记录,抑或是要删除某些文件,修改某些内容,BFG Repo-Cleaner都是一个不错的选择。

我的一个个人项目也是成功使用这个工具删除了提交记录中的一些敏感信息,下面贴出项目地址。

相关推荐
先跑起来再说12 分钟前
Git 入门到实战:一篇搞懂安装、命令、远程仓库与 IDEA 集成
ide·git·后端·elasticsearch·golang·intellij-idea
宇宙帅猴30 分钟前
GitHub 私有仓库认证完整指南:告别密码错误,使用 PAT 令牌
github
前端市界3 小时前
用 React 手搓一个 3D 翻页书籍组件,呼吸海浪式翻页,交互体验带感!
前端·架构·github
happyprince3 小时前
2026年02月07日热门github项目
github
承渊政道3 小时前
Linux系统学习【Linux系统的进度条实现、版本控制器git和调试器gdb介绍】
linux·开发语言·笔记·git·学习·gitee
Doro再努力3 小时前
【Linux操作系统12】Git版本控制与GDB调试:从入门到实践
linux·运维·服务器·git·vim
CoderJia程序员甲4 小时前
GitHub 热榜项目 - 日榜(2026-02-06)
人工智能·ai·大模型·github·ai教程
荔枝吻6 小时前
忘记服务器密码,在Xshell7中查看已保存密码
运维·服务器·github
摇滚侠6 小时前
MAC IDEA GIT 提交区显示了几个不存在的目录
git·idea
城东7 小时前
Git使用[远程仓库远端的head比本地和提交的head旧,其他人拉不到最新代码]
git·head·远程仓库远端·比本地和提交的head旧·其他人拉不到最新代码