有没有办法在一个命令中获取 git 根目录？

Question

Mercurial 有一种打印根目录（包含 .hg）的方法

hg root

git中是否有等效的东西来获取包含.git目录的目录？

Answer 1

是的：

git rev-parse --show-toplevel

如果您想更直接地复制 Mercurial 命令，可以创建一个alias：

git config --global alias.root 'rev-parse --show-toplevel'

现在git root 的功能与hg root 一样。

---

注意：在子模块中，这将显示子模块的根目录，而不是父存储库。如果您使用的是 Git >=2.13 或更高版本，有一种方法是 submodules can show the superproject's root directory. 如果您的 git 比这更旧，see this other answer.

Answer 2

--show-toplevel 是最近才被添加到 git rev-parse 还是为什么没有人提及它？

来自git rev-parse 手册页：

   --show-toplevel
       Show the absolute path of the top-level directory.

Answer 3

git-config（在别名下）的man页面说：

如果别名扩展以感叹号为前缀，将被视为shell 命令。 [...] 请注意，外壳 命令将从存储库的顶级目录执行，这可能不会 必须是当前目录。

所以，在 UNIX 上你可以这样做：

git config --global --add alias.root '!pwd'

Answer 4

“git rev-parse --git-dir”怎么样？

F:\prog\git\test\copyMerge\dirWithConflicts>git rev-parse --git-dir
F:/prog/git/test/copyMerge/.git

--git-dir 选项似乎有效。

来自git rev-parse manual page：

--git-dir

    Show $GIT_DIR if defined else show the path to the .git directory.

您可以在git setup-sh script 中看到它的实际效果。

如果您在子模块文件夹中，with Git >=2.13, use:

git rev-parse --show-superproject-working-tree

如果您使用的是git rev-parse --show-toplevel，make sure it is with Git 2.25+ (Q1 2020)。

Answer 5

这里写一个简单的答案，方便大家使用

git root

要完成这项工作，只需使用配置您的 git

git config --global alias.root "rev-parse --show-toplevel"

然后您可能希望将以下内容添加到您的~/.bashrc：

alias cdroot='cd $(git root)'

这样您就可以使用 cdroot 转到您的存储库的顶部。

Answer 6

如果您已经在顶级或不在 git 存储库中，cd $(git rev-parse --show-cdup) 将带您回家（只需 cd）。 cd ./$(git rev-parse --show-cdup) 是解决此问题的一种方法。

Answer 7

正如其他人所指出的，解决方案的核心是使用git rev-parse --show-cdup。但是，有一些边缘情况需要解决：

1. 当 cwd 已经是工作树的根时，该命令会产生一个空字符串。
   _{实际上它会产生一个空行，但是命令替换会去掉尾随的换行符。最终结果是一个空字符串。}

   大多数答案建议在输出前加上./，以便空输出在输入到cd 之前变为"./"。

2. 当 GIT_WORK_TREE 设置为不是 cwd 父级的位置时，输出可能是绝对路径名。

   在这种情况下，添加 ./ 是错误的。如果将./ 附加到绝对路径之前，它将成为相对路径（如果 cwd 是系统的根目录，它们只会引用相同的位置）。

3. 输出可能包含空格。

   这实际上只适用于第二种情况，但它有一个简单的解决方法：在命令替换周围使用双引号（以及该值的任何后续使用）。

正如其他答案所指出的那样，我们可以使用cd "./$(git rev-parse --show-cdup)"，但这会在第二个边缘情况下中断（如果我们去掉双引号，则在第三个边缘情况下）。

许多 shell 将 cd "" 视为无操作，因此对于那些 shell，我们可以执行 cd "$(git rev-parse --show-cdup)"（双引号在第一个边缘情况下保护空字符串作为参数，并在第三个边缘情况下保留空格）。 POSIX 表示 cd "" 的结果未指定，因此最好避免做出这种假设。

适用于上述所有情况的解决方案需要进行某种测试。明确地完成，它可能看起来像这样：

cdup="$(git rev-parse --show-cdup)" && test -n "$cdup" && cd "$cdup"

没有为第一个边缘情况完成cd。

如果对于第一个边缘情况运行cd .是可以接受的，那么条件可以在参数的扩展中完成：

cdup="$(git rev-parse --show-cdup)" && cd "${cdup:-.}"

Answer 8

适用于子模块、挂钩和.git 目录内的简短解决方案

这是大多数人想要的简短答案：

r=$(git rev-parse --git-dir) && r=$(cd "$r" && pwd)/ && echo "${r%%/.git/*}"

这将适用于 git 工作树中的任何位置（包括在 .git 目录内），但假定存储库目录称为 .git（这是默认值）。对于子模块，这将转到最外面的存储库的根目录。

如果要获取当前子模块的根目录，请使用：

echo $(r=$(git rev-parse --show-toplevel) && ([[ -n $r ]] && echo "$r" || (cd $(git rev-parse --git-dir)/.. && pwd) ))

要在子模块根目录中轻松执行命令，请在 .gitconfig 中的 [alias] 下添加：

sh = "!f() { root=$(pwd)/ && cd ${root%%/.git/*} && git rev-parse && exec \"$@\"; }; f"

这使您可以轻松地做git sh ag <string>之类的事情

支持不同名称或外部.git 或$GIT_DIR 目录的强大解决方案。

请注意，$GIT_DIR 可能指向外部某处（而不是称为.git），因此需要进一步检查。

把这个放在你的.bashrc：

# Print the name of the git working tree's root directory
function git_root() {
  local root first_commit
  # git displays its own error if not in a repository
  root=$(git rev-parse --show-toplevel) || return
  if [[ -n $root ]]; then
    echo $root
    return
  elif [[ $(git rev-parse --is-inside-git-dir) = true ]]; then
    # We're inside the .git directory
    # Store the commit id of the first commit to compare later
    # It's possible that $GIT_DIR points somewhere not inside the repo
    first_commit=$(git rev-list --parents HEAD | tail -1) ||
      echo "$0: Can't get initial commit" 2>&1 && false && return
    root=$(git rev-parse --git-dir)/.. &&
      # subshell so we don't change the user's working directory
    ( cd "$root" &&
      if [[ $(git rev-list --parents HEAD | tail -1) = $first_commit ]]; then
        pwd
      else
        echo "$FUNCNAME: git directory is not inside its repository" 2>&1
        false
      fi
    )
  else
    echo "$FUNCNAME: Can't determine repository root" 2>&1
    false
  fi
}

# Change working directory to git repository root
function cd_git_root() {
  local root
  root=$(git_root) || return 1  # git_root will print any errors
  cd "$root"
}

输入git_root 执行它（重启你的shell后：exec bash）

Answer 9

要计算当前 git 根目录的绝对路径，比如在 shell 脚本中使用，请使用 readlink 和 git rev-parse 的组合：

gitroot=$(readlink -f ./$(git rev-parse --show-cdup))

git-rev-parse --show-cdup 为您提供正确数量的“..”以获取 从您的 cwd 到根目录，或者如果您在根目录，则为空字符串。 然后在前面加上“./”来处理空字符串大小写并使用 readlink -f 转换为完整路径。

您还可以在 PATH 中创建一个 git-root 命令作为 shell 脚本来应用此技术：

cat > ~/bin/git-root << EOF
#!/bin/sh -e
cdup=$(git rev-parse --show-cdup)
exec readlink -f ./$cdup
EOF
chmod 755 ~/bin/git-root

（上面可以粘贴到终端创建git-root并设置执行位；实际脚本在第2、3和4行。）

然后您就可以运行git root 来获取当前树的根。 请注意，在shell脚本中，如果rev-parse失败，请使用“-e”使shell退出，这样如果您不在git目录中，您可以正确获取退出状态和错误消息。

Answer 10

以防万一您将此路径提供给 Git 本身，请使用 :/

# this adds the whole working tree from any directory in the repo
git add :/

# and is equal to
git add $(git rev-parse --show-toplevel)

Answer 11

稍微修改一下“git config”的答案：

git config --global --add alias.root '!pwd -P'

并清理路径。很不错。

Answer 12

如果您正在寻找一个好的别名来执行此操作，并且如果您不在 git 目录中，请不要炸毁 cd：

alias ..g='git rev-parse && cd "$(git rev-parse --show-cdup)"'

Answer 13

git-extras

添加$ git root
见https://github.com/tj/git-extras/blob/master/Commands.md#git-root

$ pwd
.../very-deep-from-root-directory
$ cd `git root`
$ git add . && git commit

git-extras 的可用性

• homebrew(osx)/linuxbrew(linux)$ brew install git-extras
• debian/ubuntu repos (https://packages.debian.org/sid/git-extras) $ apt-get install git-extras

Answer 14

无论您是在 git 子目录中还是在顶层，此 shell 别名都有效：

alias gr='[ ! -z `git rev-parse --show-toplevel` ] && cd `git rev-parse --show-toplevel || pwd`'

更新为使用现代语法而不是反引号：

alias gr='[ ! -z $(git rev-parse --show-toplevel) ] && cd $(git rev-parse --show-toplevel || pwd)'

Answer 15

alias git-root='cd \`git rev-parse --git-dir\`; cd ..'

其他一切都在某个时候失败，要么进入主目录，要么惨遭失败。这是返回 GIT_DIR 的最快、最短的方法。

Answer 16

这是我编写的处理这两种情况的脚本：1) 带有工作区的存储库，2) 裸存储库。

https://gist.github.com/jdsumsion/6282953

git-root（路径中的可执行文件）：

#!/bin/bash
GIT_DIR=`git rev-parse --git-dir` &&
(
  if [ `basename $GIT_DIR` = ".git" ]; then
    # handle normal git repos (with a .git dir)
    cd $GIT_DIR/..
  else
    # handle bare git repos (the repo IS a xxx.git dir)
    cd $GIT_DIR
  fi
  pwd
)

希望这会有所帮助。

Answer 17

$ git config alias.root '!pwd'
# then you have:
$ git root

Answer 18

从Git 2.13.0开始，它支持显示根项目路径的新选项，即使在子模块内部使用也可以：

git rev-parse --show-superproject-working-tree

Answer 19

Shell 框架中预配置的 Shell 别名

如果您使用 shell 框架，可能已经有可用的 shell 别名：

• $ grt in oh-my-zsh (68k) (cd $(git rev-parse --show-toplevel || echo "."))
• $ git-root in prezto (8.8k)（显示工作树根的路径）
• $ g..zimfw (1k)（将当前目录更改为工作树的顶层。）

Answer 20

我想扩展 Daniel Brockman 的出色评论。

定义git config --global alias.exec '!exec ' 允许您执行git exec make 之类的操作，因为正如man git-config 所述：

如果别名扩展以感叹号为前缀，它将被视为 shell 命令。 [...] 请注意，shell 命令将从存储库的顶级目录执行，该目录可能不一定是当前目录。

知道$GIT_PREFIX 将是当前目录相对于存储库顶级目录的路径也很方便。但是，知道这只是成功的一半™。 Shell 变量扩展使其很难使用。所以我建议像这样使用bash -c：

git exec bash -c 'ls -l $GIT_PREFIX'

其他命令包括：​​

git exec pwd
git exec make

Answer 21

如果有人需要符合 POSIX 标准的方式来执行此操作，而不需要 git 可执行文件：

git-root:

#$1: Path to child directory
git_root_recurse_parent() {
    # Check if cwd is a git root directory
    if [ -d .git/objects -a -d .git/refs -a -f .git/HEAD ] ; then
        pwd
        return 0
    fi

    # Check if recursion should end (typically if cwd is /)
    if [ "${1}" = "$(pwd)" ] ; then
        return 1
    fi

    # Check parent directory in the same way
    local cwd=$(pwd)
    cd ..
    git_root_recurse_parent "${cwd}"
}

git_root_recurse_parent

---

如果您只想将该功能作为脚本的一部分，请删除 shebang，并将最后一行 git_root_recurse_parent 替换为：

git_root() {
    (git_root_recurse_parent)
}

Answer 22

今天必须自己解决这个问题。在 C# 中解决了它，因为我需要它用于程序，但我想它可以很容易地重写。考虑一下这个公共领域。

public static string GetGitRoot (string file_path) {

    file_path = System.IO.Path.GetDirectoryName (file_path);

    while (file_path != null) {

        if (Directory.Exists (System.IO.Path.Combine (file_path, ".git")))
            return file_path;

        file_path = Directory.GetParent (file_path).FullName;

    }

    return null;

}