Question

我无法弄清楚如何使用git blame来获取曾经触及给定范围的行的提交集。有类似问题，如this one，但接受的答案并没有给我带来更多进展。

假设我的定义从foo.rb的第1000行开始。它只有5行长，但改变这些行的提交数量是巨大的。如果我做

git blame foo.rb -L 1000,+5

我得到了（最多）五个不同的提交，这些提交改变了这些行，但我也对“它们背后”的提交感兴趣。

类似地，

git rev-list HEAD -- foo.rb | xargs git log --oneline

几乎是我想要的，但我不能指定行范围为git rev-list

我可以将标志传递给git blame以获取曾经触及这五行的提交列表，或者构建提取此类信息的脚本的最快方法是什么？让我们暂时忽略定义曾经多于或少于5行的可能性。

Answer 1

Since Git 1.8.4，git log有-L来查看一系列行的演变。

例如，假设您查看git blame的输出：

((aa27064...))[mlm@macbook:~/w/mlm/git]
$ git blame -L150,+11 -- git-web--browse.sh
a180055a git-web--browse.sh (Giuseppe Bilotta 2010-12-03 17:47:36 +0100 150)            die "The browser $browser is not
a180055a git-web--browse.sh (Giuseppe Bilotta 2010-12-03 17:47:36 +0100 151)    fi
5d6491c7 git-browse-help.sh (Christian Couder 2007-12-02 06:07:55 +0100 152) fi
5d6491c7 git-browse-help.sh (Christian Couder 2007-12-02 06:07:55 +0100 153) 
5d6491c7 git-browse-help.sh (Christian Couder 2007-12-02 06:07:55 +0100 154) case "$browser" in
81f42f11 git-web--browse.sh (Giuseppe Bilotta 2010-12-03 17:47:38 +0100 155) firefox|iceweasel|seamonkey|iceape)
5d6491c7 git-browse-help.sh (Christian Couder 2007-12-02 06:07:55 +0100 156)    # Check version because firefox < 2.0 do
5d6491c7 git-browse-help.sh (Christian Couder 2007-12-02 06:07:55 +0100 157)    vers=$(expr "$($browser_path -version)" 
5d6491c7 git-browse-help.sh (Christian Couder 2007-12-02 06:07:55 +0100 158)    NEWTAB='-new-tab'
5d6491c7 git-browse-help.sh (Christian Couder 2007-12-02 06:07:55 +0100 159)    test "$vers" -lt 2 && NEWTAB=''
a0685a4f git-web--browse.sh (Dmitry Potapov   2008-02-09 23:22:22 -0800 160)    "$browser_path" $NEWTAB "$@" &

你想知道现在的第155行的历史。

然后：

((aa27064...))[mlm@macbook:~/w/mlm/git]
$ git log --topo-order --graph -u -L 155,155:git-web--browse.sh
* commit 81f42f11496b9117273939c98d270af273c8a463
| Author: Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
| Date:   Fri Dec 3 17:47:38 2010 +0100
| 
|     web--browse: support opera, seamonkey and elinks
|     
|     The list of supported browsers is also updated in the documentation.
|     
|     Signed-off-by: Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
|     Signed-off-by: Junio C Hamano <gitster@pobox.com>
| 
| diff --git a/git-web--browse.sh b/git-web--browse.sh
| --- a/git-web--browse.sh
| +++ b/git-web--browse.sh
| @@ -143,1 +143,1 @@
| -firefox|iceweasel)
| +firefox|iceweasel|seamonkey|iceape)
|  
* commit a180055a47c6793eaaba6289f623cff32644215b
| Author: Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
| Date:   Fri Dec 3 17:47:36 2010 +0100
| 
|     web--browse: coding style
|     
|     Retab and deindent choices in case statements.
|     
|     Signed-off-by: Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
|     Signed-off-by: Junio C Hamano <gitster@pobox.com>
| 
| diff --git a/git-web--browse.sh b/git-web--browse.sh
| --- a/git-web--browse.sh
| +++ b/git-web--browse.sh
| @@ -142,1 +142,1 @@
| -    firefox|iceweasel)
| +firefox|iceweasel)
|  
* commit 5884f1fe96b33d9666a78e660042b1e3e5f9f4d9
  Author: Christian Couder <chriscool@tuxfamily.org>
  Date:   Sat Feb 2 07:32:53 2008 +0100

      Rename 'git-help--browse.sh' to 'git-web--browse.sh'.

      Signed-off-by: Christian Couder <chriscool@tuxfamily.org>
      Signed-off-by: Junio C Hamano <gitster@pobox.com>

  diff --git a/git-web--browse.sh b/git-web--browse.sh
  --- /dev/null
  +++ b/git-web--browse.sh
  @@ -0,0 +127,1 @@
  +    firefox|iceweasel)

如果经常使用此功能，您可能会发现git别名很有用。为此，请加入~/.gitconfig：

[alias]
    # Follow evolution of certain lines in a file
    # arg1=file, arg2=first line, arg3=last line or blank for just the first line
    follow = "!sh -c 'git log --topo-order -u -L $2,${3:-$2}:"$1"'" -

现在你可以做git follow git-web--browse.sh 155。

Answer 2

我认为这就是你想要的：

git rev-list HEAD -- foo.rb | ( 
    while read rev; do
        git blame -l -L 1000,+5 $rev -- foo.rb | cut -d ' ' -f 1
    done;
) | awk '{ if (!h[$0]) { print $0; h[$0]=1 } }'

这将输出每个提交的修订号，该提交对您选择的行进行编辑。

以下是步骤：

第一部分git rev-list HEAD -- foo.rb输出编辑所选文件的所有修订版。
然后，每个修订都会进入第二部分，每部分都会将每一部分放入git blame -l -L 1000,+5 $rev -- foo.rb | cut -d ' ' -f 1。这是一个由两部分组成的命令。
1. git blame -l -L 1000,+5 $rev -- foo.rb输出所选行的责任。通过向它提供修订号，我们告诉它从该提交开始并从那里开始，而不是从头开始。
2. 由于blame输出了一堆我们不需要的信息，cut -d ' ' -f 1为我们提供了blame输出的第一列（修订版号）。
awk '{ if (!h[$0]) { print $0; h[$0]=1 } }'取出不相邻的重复行，同时保持它们出现的顺序。有关此命令的详细信息，请参阅http://jeetworks.org/node/94。

你可以在这里添加最后一步以获得更漂亮的输出。将所有内容传递到xargs -L 1 git log --oneline -1并获取修订列表的相应提交消息。我有一个奇怪的问题，使用这最后一步，我必须继续按下输出的每几个修订。我不确定为什么会这样，这就是为什么我没有把它包含在我的解决方案中。

Answer 3

不确定你想做什么，但也许 git log -S 可以帮到你：

-S<string>
    Look for differences that introduce or remove an instance of <string>. 
    Note that this is different than the string simply appearing
    in diff output; see the pickaxe entry in gitdiffcore(7) for more
    details.

您可以在字符串中输入您要遵循的更改（或部分更改），这将列出曾经触及此更改的提交。

Answer 4

我喜欢这个谜题，它有它的微妙之处。来源此文件，说init foo.rb 1000,1005并按照说明操作。完成后，文件@changes将按照拓扑顺序包含正确的提交列表，@blames将具有每个提交的实际错误输出。

这比the accepted solution above复杂得多。它产生的输出有时会更有用，而且难以重现，编码很有趣。

尝试在逐步浏览历史记录时自动跟踪行号范围的问题是，如果更改块穿过行编号范围边界，则无法自动确定新范围边界应该在该块中的哪个位置，并且您' ll要么必须包括大范围的大增加，所以累积（有时很多）无关的变化，或者进入手动模式以确保它是正确的（当然这会让你回到这里），或者有时接受极端的损失。

如果你想要你的输出是准确的，使用上面的答案与值得信赖的正则表达式范围，如`/ ^ type function（/，/ ^} /'，或使用它，这实际上并不那么糟糕，几秒钟每一步回到过去。

为了换取额外的复杂性，它确实以拓扑顺序产生了命中列表，并且它至少（相当成功地）尝试改善每一步的痛苦。例如，它永远不会运行多余的责任，而更新范围使得调整行号更容易。当然还有必须单独关注帅哥的可靠性...... :-P

要在全自动状态下运行此功能，请说{ init foo.rb /^class foo/,/^end/; auto; } 2>&-

 ### functions here create random @-prefix files in the current directory ###
#
# git blame history for a range, finding every change to that range
# throughout the available history.  It's somewhat, ahh, "intended for
# customization", is that enough of a warning?  It works as advertised
# but drops @-prefix temporary files in your current directory and
# defines new commands
#
# Source this file in a subshell, it defines functions for your use.
# If you have @-prefix files you care about, change all @ in this file
# to something you don't have and source it again.
#
#    init path/to/file [<start>,<end>]  # range optional
#    update-ranges           # check range boundaries for the next step
#    cycle [<start>,<end>]   # range unchanged if not supplied
#    prettyblame             # pretty colors, 
#       blue="child commit doesn't have this line"
#       green="parent commit doesn't have this line"
#           brown=both
#    shhh # silence the pre-cycle blurb
#
# For regex ranges, you can _usually_ source this file and say `init
# path/to/file /startpattern/,/endpattern/` and then cycle until it says 0
# commits remain in the checklist
#
# for line-number ranges, or regex ranges you think might be unworthy, you
# need to check and possibly update the range before each cycle.  File
# @next is the next blame start-point revision text; and command
# update-ranges will bring up vim with the current range V-selected.  If
# that looks good, `@M` is set up to quit even while selecting, so `@M` and
# cycle.  If it doesn't look good, 'o' and the arrow keys will make getting
# good line numbers easy, or you can find better regex's.  Either way, `@M`
# out and say `cycle <start>,<end>` to update the ranges.

init () { 
    file=$1;
    range="$2"
    rm -f @changes
    git rev-list --topo-order HEAD -- "$file" \
    | tee @checklist \
    | cat -n | sort -k2 > @sequence
    git blame "-ln${range:+L$range}" -- "$file" > @latest || echo >@checklist
    check-cycle
    cp @latest @blames
}

update-latest-checklist() {
    # update $latest with the latest sha that actually touched our range,
    # and delete that and everything later than that from the checklist.
    latest=$(
        sed s,^^,, @latest \
        | sort -uk1,1 \
        | join -1 2 -o1.1,1.2 @sequence - \
        | sort -unk1,1 \
        | sed 1q \
        | cut -d" " -f2
    )
    sed -i 1,/^$latest/d @checklist
}
shhh () { shhh=1; }

check-cycle () {
    update-latest-checklist
    sed -n q1 @checklist || git log $latest~..$latest --format=%H\ %s | tee -a @changes
    next=`sed 1q @checklist`
    git cat-file -p `git rev-parse $next:"$file"` > @next
    test -z "$shh$shhh$shhhh" && {
        echo "A blame from the (next-)most recent alteration (id `git rev-parse --short $latest`) to '$file'"
        echo is in file @latest, save its contents where you like
        echo 
        echo you will need to look in file @next to determine the correct next range,
        echo and say '`cycle its-start-line,its-end-line`' to continue
        echo the "update-ranges" function starts you out with the range selected
    } >&2
    ncommits=`wc -l @checklist | cut -d\  -f1`
    echo  $ncommits commits remain in the checklist >&2
    return $((ncommits==0))
}

update-ranges () {
    start="${range%,*}"
    end="${range#*,}"
    case "$start" in
    */*)    startcmd="1G$start"$'\n' ;;
    *)      startcmd="${start}G" ;;
    esac
    case "$end" in
    */*)    endcmd="$end"$'\n' ;;
    [0-9]*) endcmd="${end}G" ;;
    +[0-9]*) endcmd="${end}j" ;;
    *) endcmd="echohl Search|echo "can\'t" get to '${end}'\"|echohl None" ;;
    esac
    vim -c 'set buftype=nofile|let @m=":|q'$'\n"' -c "norm!${startcmd}V${endcmd}z.o" @next
}

cycle () {
    sed -n q1 @checklist && { echo "No more commits to check"; return 1; }
    range="${1:-$range}"
    git blame "-ln${range:+L$range}" $next -- "$file" >@latest || echo >@checklist
    echo >>@blames
    cat @latest >>@blames
    check-cycle
}

auto () {
    while cycle; do true; done
}

prettyblames () {
cat >@pretty <<-\EOD
BEGIN {
    RS=""
    colors[0]="\033[0;30m"
    colors[1]="\033[0;34m"
    colors[2]="\033[0;32m"
    colors[3]="\033[0;33m"
    getline commits < "@changes"
    split(commits,commit,/\n/)
}
NR!=1 { print "" }
{
    thiscommit=gensub(/ .*/,"",1,commit[NR])
    printf "%s\n","\033[0;31m"commit[NR]"\033[0m"
    split($0,line,/\n/)
    for ( n=1; n<=length(line); ++n ) {
        color=0
        split(line[n],key,/[1-9][0-9]*)/)
        if ( NR!=1 && !seen[key[1]] ) color+=1
        seen[key[1]]=1;
        linecommit = gensub(/ .*/,"",1,line[n])
        if (linecommit==thiscommit) color+=2
        printf "%s%s\033[0m\n",colors[color],line[n]
    }
}
EOD
awk -f @pretty @blames | less -R
}

Answer 5

请参阅此处发布的答案List all commits for a specific file。这正是你所需要的。

Answer 6

一些想法..

这听起来类似于this post，看起来你可能会接近这样的事情：

git blame -L '/variable_name *= */',+1

只要您知道要匹配的定义（对于正则表达式）。

有一个帖子discussion here，关于使用tig和git gui（显然可以处理此问题）。我还没有尝试过这个，所以无法验证它（稍后我会试一试）。

Git：发现哪些提交触及了一系列行

6 个答案: