修改git提交commit信息NAME和EMAIL

(Owed by: 春夜喜雨 http://blog.csdn.net/chunyexiyu)
参考：https://git-scm.com/docs/git-filter-branch
参考：https://git-scm.com/docs/git-commit
参考：https://www.codenong.com/2919878/
参考：https://scarletsky.github.io/2016/12/29/tilde-and-caret-in-git/

如果你也碰到git/github上提交用户名或者email错误的话，下面介绍的修改方法可能可以帮助到你。
修改commit记录，主要通过使用git filter-branch命令来实现。

1. git filter-branch说明

git filter-branch功能很强大，可以用于对commit记录的修改，修改结果也是比较符合预期的。
当然用的时候也要特别小心，因为该修改并不可逆，如果提交修改后，再想回退就比较困难了。
因为数据回退需要commit历史，还原依赖commit历史；而当前修改的正是commit历史记录，对回退依据的修改是不可回退的。

git filter-branch在官方的声明中标识：
使用该命令，可能会对预期的历史重写造成不明显的破坏，不建议使用。
如果您仍然需要使用git filter branch，请仔细阅读安全（和性能）以了解filter branch的缺陷，然后警惕地尽可能避免其中列出的危险。

语法：

git filter-branch [–setup ] [–subdirectory-filter ]
[–env-filter ] [–tree-filter ]
[–index-filter ] [–parent-filter ]
[–msg-filter ] [–commit-filter ]
[–tag-name-filter ] [–prune-empty]
[–original ] [-d ] [-f | --force]
[–state-branch ] [–] […]

我们对于提交name/email的修改使用的命令是其中的一项：–env-filter，另外添加-f选项，可选添加的修改范围rev-list
–env-filter

This filter may be used if you only need to modify the environment in which the commit will be performed.
Specifically, you might want to rewrite the author/committer name/email/time environment variables.
The argument is always evaluated in the shell context using the eval command (with the notable exception of the commit filter, for technical reasons).
If any evaluation of returns a non-zero exit status, the whole operation will be aborted.

-f/–force

git filter-branch refuses to start with an existing temporary directory or when there are already refs starting with refs/original/, unless forced.

rev-list options

Arguments for git rev-list.
All positive refs included by these options are rewritten.
You may also specify options such as --all, but you must use – to separate them from the git filter-branch options. Implies Remap to ancestor.
By using git-rev-list[1] arguments, e.g., path limiters, you can limit the set of revisions which get rewritten.
例如：范围使用 HEAD~2…HEAD，只修改最近的二次提交版本

2. env-filter说明与打印信息

env-filter专注于提交名称、提交email、提交日期的重写，包含下面几项：
GIT_AUTHOR_NAME
GIT_AUTHOR_EMAIL
GIT_AUTHOR_DATE
GIT_COMMITTER_NAME
GIT_COMMITTER_EMAIL
GIT_COMMITTER_DATE

windows下可以通过下面命令打印出信息：
// 经尝试linux下，windows下命令可以打印出来，linux下打印不出来
—打印GIT_COMMITTER_NAME

git filter-branch -f --env-filter "echo $GIT_COMMITTER_NAME; "

—打印AUTHOR信息

git filter-branch -f --env-filter "echo $GIT_AUTHOR_NAME, $GIT_AUTHOR_EMAIL, $GIT_AUTHOR_DATE; "

—打印COMMITTER信息

git filter-branch -f --env-filter "echo $GIT_COMMITTER_NAME, $GIT_COMMITTER_EMAIL, $GIT_COMMITTER_DATE; "

3. 通过env-filter无条件改写信息

无条件重写比较简单，但无条件重写意味着不加判断的重写，会把所有涉及项重写；
注意：可能是他人的提交内容也被重写，要慎重使用。
无条件重写命令比较简单，如下所示，注意赋值时没有$取值符号；
样例：
—重写COMMIT-NAME

git filter-branch -f --env-filter "GIT_COMMITTER_NAME=‘DemoName’; "

—重写AUTOR

git filter-branch -f --env-filter "GIT_AUTHOR_NAME=‘AuthName’; GIT_AUTHOR_EMAIL=‘AuthEmail’; "

—重写COMMIT

git filter-branch -f --env-filter “GIT_COMMITTER_NAME=‘CommitName’; GIT_COMMITTER_EMAIL=‘CommitEmail’;”

4. 通过env-filter条件判断改写信息

有条件重写通常是比较可靠一点的，基于条件判定是否重写，通常用起来会比较安全一点；
基于判定，匹配条件时再重写，但是对于这个表达式，linux与windows下并不一致，需要分开来写，另外需要注意表达式中[]前后均需要有空格。
注意：使用前做好备份，可能会当前的refs/heads/master造成损坏的影响，此时一方面是不提交，另一方面是从新clone下载
注意：windows与linux使用不同命令，尝试发现，下面这种条件替换命令，使用’与"差异也会造成命令执行异常

样例：windows下使用命令
—替换COMMIT-NAME

git filter-branch -f --env-filter "if [ $GIT_COMMITTER_NAME == ‘CommitName’ ]; then GIT_COMMITTER_NAME=‘Demo’; fi "

—替换AUTHOR-NAME

git filter-branch -f --env-filter "if [ $GIT_AUTHOR_NAME == ‘AuthName’ ]; then GIT_AUTHOR_NAME=‘Demo’; fi "

—替换COMMIT-EMAIL

git filter-branch -f --env-filter "if [ $GIT_COMMITTER_EMAIL == ‘CommitEmail’ ]; then GIT_COMMITTER_EMAIL=‘Demo’; fi "

—替换AUTHOR-EMAIL

git filter-branch -f --env-filter "if [ $GIT_AUTHOR_EMAIL == ‘AuthEmail’ ]; then GIT_AUTHOR_EMAIL=‘Demo’; fi "

样例：linux下使用命令
—替换COMMIT-NAME

git filter-branch -f --env-filter 'if [ “$GIT_COMMITTER_NAME” = “CommitName” ]; then GIT_COMMITTER_NAME=“Demo”; fi ’

—替换AUTHOR-NAME

git filter-branch -f --env-filter 'if [ “$GIT_AUTHOR_NAME” = “AuthName” ]; then GIT_AUTHOR_NAME=“Demo”; fi ’

—替换COMMIT-EMAIL

git filter-branch -f --env-filter 'if [ “$GIT_COMMITTER_EMAIL” = “CommitEmail” ]; then GIT_COMMITTER_EMAIL=“Demo”; fi ’

—替换AUTHOR-EMAIL

git filter-branch -f --env-filter 'if [ “$GIT_AUTHOR_EMAIL” = “AuthEmail” ]; then GIT_AUTHOR_EMAIL=“Demo”; fi ’

5. 附加说明

修改之后，使用git log查看日志是否已经被改写好了

git log

如果发现出现了异常，那就不要提交修改了，使用git clone重新获取git库，丢弃掉修改内容

git clone xxx.git

如果改写好了，就可以使用git push -f来提交改写了

git push -f

另外修改时，也可以指定分支范围：
例如只修改最后一次提交内容，就可以指定rev-list为

git filter-branch -f --env-filter "GIT_AUTHOR_NAME=‘DemoName’; " HEAD~…HEAD

例如：修改最近三次提交的记录(~的用法参见参考文档中)

git filter-branch -f --env-filter "GIT_AUTHOR_NAME=‘DemoName’; " HEAD~3…HEAD

(Owed by: 春夜喜雨 http://blog.csdn.net/chunyexiyu)