初次使用 git 的“核弹级选项”：filter-branch

4
22
2011

初次使用 git 的“核弹级选项”：filter-branch

本文来自依云's Blog，转载请注明。

当初看 Pro Git 时就被作者这个“核弹级选项”的称呼吓到了，因此一直没敢好奇地去尝试。核弹啊，用对了威力无穷，用错了破坏力无穷！

但是，今天，我不得不用了，因为我想把我的 Python 脚本放到 github 上去公开。由于之前没想过要公开，所以不能肯定是不是把诸如密码之类的敏感数据直接写代码里了。于是我就用 git 的 pickaxe 选项-S来找找看。这个我也是今天才学到的哦，来源是stackoverflow上的若干问题，具体记不清了。

这个选项结合git log，其功能是把提交中包含某个文本的提交找出来。比如git log --stat -S密码就把所有提交中包含“密码”二字的提交找出来了，同时--stat告诉 git 我希望看到文件列表，以确定敏感数据在哪个文件里。另外说下zsh，我设置了hist_ignore_space选项，所以当查找密码时我在命令行最开始输入个空格，这样 zsh 就不会把这条命令写到命令历史里。

找了下，还真发现了两个包含密码的文件（其中之一 base64 过，另一个直接明文。。。）。我决定把它们转移到其它目录下，所以要删除这些文件。同时我意外地发现，有些提交中我引用了之前的提交，比如“(after xxx) fix xxx”这种。重写 git 历史后这些提交的 sha1 值会改变，所以这些提交信息也要重写。最开始我想把提交 sha1 修改为重写后的值，后来发现有点麻烦，得通过提交 sha1 查询一个备份中的提交信息（如果不事先保存相关信息的话），然后再通过提交信息查询重写后的提交的 sha1 值，还不知道 filter-branch 时能不能查询历史，于是作罢。还好这个仓库中只有一个这样的提交，所以我直接修改成~n表示引用第 n 次前的提交算了。最后，整个命令出来了：

git filter-branch --tree-filter 'rm -rf files_to_remove' --msg-filter '
sed s/d101601/~8/
' --prune-empty -f HEAD --all

命令挺复杂的，所以我是调用 Vim 写好的，然后在一个 clone 出来的仓库里先试运行。先解释下各个参数：

--tree-filter表示修改文件列表。
--msg-filter表示修改提交信息，原提交信息从标准输入读入，新提交信息输出到标准输出。
--prune-empty表示如果修改后的提交为空则扔掉不要。在一次试运行中我发现虽然文件被删除了，但是还剩下个空的提交，就查了下 man 文档，找到了这个选项。
-f是忽略备份。不加这个选项第二次运行这个命令时会出错，意思是 git 上次做了备份，现在再要运行的话得处理掉上次的备份。
--all是针对所有的分支。

试运行了几次，看到 150 多次提交逐一被重写，然后检查下，发现要删除的文件确实被删除了。于是高兴地到 github 建立新仓库，把脚本上传了。仓库名叫winterpy，因为网友 Vayn 建议我用 summerpy，而我更喜欢冬季 :-P

折腾完毕，我更加喜欢 git 了 :-)

Category: 版本控制 | Tags: python Git | Read Count: 27055