使用 Git 检查脏索引或未跟踪文件

Question

如何检查我的 git 存储库中是否有任何未提交的更改：

1. 已添加到索引但未提交的更改
2. 未跟踪的文件

来自脚本？

git-status 在 git 版本 1.6.4.2 中似乎总是返回零。

Answer 1

为什么不用一个脚本封装 'git status：

• 将分析该命令的输出
• 将根据您的需要返回相应的错误代码

这样，您可以在脚本中使用“增强”状态。

---

正如0xfe 在他的excellent answer 中提到的那样，git status --porcelain 在任何基于脚本的解决方案中都非常有用

--porcelain

以稳定、易于解析的脚本格式提供输出。
目前这与--short output 相同，但保证将来不会更改，从而使其对脚本安全。

Answer 2

好时机！几天前我写了一篇关于这个的博客文章，当时我想出了如何将 git 状态信息添加到我的提示符中。

这是我的工作：

1. 脏状态：

   # Returns "*" if the current git branch is dirty.
   function evil_git_dirty {
     [[ $(git diff --shortstat 2> /dev/null | tail -n1) != "" ]] && echo "*"
   }
   

2. 对于未跟踪的文件（注意git status 的--porcelain 标志，它可以为您提供很好的可解析输出）：

   # Returns the number of untracked files
   
   function evil_git_num_untracked_files {
     expr `git status --porcelain 2>/dev/null| grep "^??" | wc -l` 
   }
   

虽然git diff --shortstat更方便，但你也可以使用git status --porcelain来获取脏文件：

# Get number of files added to the index (but uncommitted)
expr $(git status --porcelain 2>/dev/null| grep "^M" | wc -l)

# Get number of files that are uncommitted and not added
expr $(git status --porcelain 2>/dev/null| grep "^ M" | wc -l)

# Get number of total uncommited files
expr $(git status --porcelain 2>/dev/null| egrep "^(M| M)" | wc -l)

注意：2>/dev/null 过滤掉错误消息，因此您可以在非 git 目录上使用这些命令。 （他们将简单地返回 0 以获取文件计数。）

编辑：

以下是帖子：

Adding Git Status Information to your Terminal Prompt

Improved Git-enabled Shell Prompt

Answer 3

一种 DIY 可能性，已更新以遵循 0xfe 的建议

#!/bin/sh
exit $(git status --porcelain | wc -l) 

如 Chris Johnsen 所述，这只适用于 Git 1.7.0 或更高版本。

Answer 4

可靠地“编写”Git 的关键是使用“管道”命令。

开发人员在更改管道命令时要小心，以确保它们提供非常稳定的接口（即存储库状态、标准输入、命令行选项、参数等的给定组合将在所有版本的 Git 中产生相同的输出，其中命令/选项存在）。管道命令的新输出变化可以通过新选项引入，但这不会给已经针对旧版本编写的程序引入任何问题（它们不会使用新选项，因为它们不存在（或者至少是未使用）在编写脚本时）。

不幸的是，“日常”Git 命令是“瓷器”命令，因此大多数 Git 用户可能不熟悉管道命令。瓷器和管道命令之间的区别主要在git manpage 中进行（参见标题为High-level commands (porcelain) 和Low-level commands (plumbing) 的小节。

---

要了解未提交的更改，您可能需要git diff-index（比较索引（可能是工作树的跟踪位）与其他一些树状结构（例如HEAD）），可能需要git diff-files（比较工作树与index)，可能还有git ls-files（列出文件；例如列出未跟踪、未忽略的文件）。

（请注意，在下面的命令中，HEAD -- 被用来代替 HEAD，否则如果有一个名为 HEAD 的文件，则使用命令 fails。）

要检查存储库是否已暂存更改（尚未提交），请使用：

git diff-index --quiet --cached HEAD --

• 如果它以0 退出，则没有差异（1 表示存在差异）。

检查工作树是否有可以暂存的更改：

git diff-files --quiet

• 退出代码与git diff-index 相同（0 == 无差异；1 == 差异）。

检查工作树中索引和跟踪文件的组合是否相对于HEAD有变化：

git diff-index --quiet HEAD --

• 这就像前两者的组合。一个主要区别是，如果您在工作树中有“撤消”的分阶段更改（返回到HEAD 中的内容），它仍然会报告“无差异”。在同样的情况下，两个单独的命令都会返回“存在差异”的报告。

您还提到了未跟踪的文件。您的意思可能是“未跟踪和未忽略”，或者您可能只是简单的“未跟踪”（包括被忽略的文件）。无论哪种方式，git ls-files 都是工作的工具：

对于“未跟踪”（将包括被忽略的文件，如果存在）：

git ls-files --others

对于“未跟踪和未忽略”：

git ls-files --exclude-standard --others

我的第一个想法是检查这些命令是否有输出：

test -z "$(git ls-files --others)"

• 如果它以0 退出，则没有未跟踪的文件。如果它以1 退出，则存在未跟踪的文件。

这很有可能会将来自git ls-files 的异常退出转换为“没有未跟踪的文件”报告（两者都导致上述命令的非零退出）。更强大的版本可能如下所示：

u="$(git ls-files --others)" && test -z "$u"

• 这个想法与前面的命令相同，但它允许来自git ls-files 的意外错误传播出去。在这种情况下，非零退出可能意味着“有未跟踪的文件”或者可能意味着发生了错误。如果您希望“错误”结果与“无未跟踪文件”结果相结合，请使用test -n "$u"（其中0 的退出表示“一些未跟踪文件”，非零表示错误或“没有未跟踪文件”） .

另一个想法是在没有未跟踪的文件时使用--error-unmatch 导致非零退出。这也存在将“没有未跟踪的文件”（退出1）与“发生错误”（退出非零，但可能是128）混为一谈的风险。但是检查0 与1 与非零退出代码可能相当稳健：

git ls-files --others --error-unmatch . >/dev/null 2>&1; ec=$?
if test "$ec" = 0; then
    echo some untracked files
elif test "$ec" = 1; then
    echo no untracked files
else
    echo error from ls-files
fi

如果您只想考虑未跟踪和未忽略的文件，则上述任何 git ls-files 示例都可以采用 --exclude-standard。

Answer 5

假设您使用的是 git 1.7.0 或更高版本...

在阅读了此页面上的所有答案并进行了一些实验后，我认为正确结合简洁的方法是：

test -n "$(git status --porcelain)"

虽然 git 允许在跟踪的内容、忽略的内容、未跟踪但未忽略的内容等之间存在很多细微差别，但我相信典型的用例是自动化构建脚本，如果你的结帐不干净，你想停止一切.

在这种情况下，模拟程序员会做什么是有意义的：输入git status 并查看输出。但是我们不想依赖特定的单词出现，所以我们使用 1.7.0 中引入的--porcelain 模式；启用后，干净的目录不会导致输出。

然后我们用test -n看有没有输出。

如果工作目录是干净的，此命令将返回 1，如果有更改要提交，则返回 0。如果您想要相反，您可以将-n 更改为-z。这对于将其链接到脚本中的命令很有用。例如：

test -z "$(git status --porcelain)" || red-alert "UNCLEAN UNCLEAN"

这实际上是说“要么不做任何改变，要么触发警报”；根据您编写的脚本，这种单行语句可能比 if 语句更可取。

Answer 6

这是一个更适合 shell 的变体，用于找出存储库中是否存在 任何 未跟踪的文件：

# Works in bash and zsh
if [[ "$(git status --porcelain 2>/dev/null)" = *\?\?* ]]; then
  echo untracked files
fi

这不会派生第二个进程grep，并且不需要检查您是否在 git 存储库中。这对于 shell 提示等很方便。

Answer 7

来自VonC 的回答的实现：

if [[ -n $(git status --porcelain) ]]; then echo "repo is dirty"; fi

Answer 8

可能有来自这个线程的更好的答案组合......但这对我有用......对于你的.gitconfig的[alias]部分......

          # git untracked && echo "There are untracked files!"
untracked = ! git status --porcelain 2>/dev/null | grep -q "^??"
          # git unclean && echo "There are uncommited changes!"
  unclean = ! ! git diff --quiet --ignore-submodules HEAD > /dev/null 2>&1
          # git dirty && echo "There are uncommitted changes OR untracked files!"
    dirty = ! git untracked || git unclean

Answer 9

我用来检测脏状态的最简单的自动测试 = 任何更改，包括未跟踪的文件：

git add --all
git diff-index --exit-code HEAD

备注：

• 没有add --all，diff-index 不会注意到未跟踪的文件。
• 通常我在测试错误代码后运行 git reset 以取消暂存所有内容。
• 考虑--quiet 而不是--exit-code 以避免输出。

Answer 10

你也可以这样做

git describe --dirty

。如果它检测到脏工作树，它将在末尾附加单词“-dirty”。根据git-describe(1)：

   --dirty[=<mark>]
       Describe the working tree. It means describe HEAD and appends <mark> (-dirty by default) if
       the working tree is dirty.

。警告：未跟踪的文件不被视为“脏”，因为正如手册页所述，它只关心工作树。

Answer 11

浏览了其中一些答案...（并且在 *nix 和 windows 上遇到了各种问题，这是我的要求）...发现以下效果很好...

git diff --no-ext-diff --quiet --exit-code

检查 *nix 中的退出代码

echo $?   
#returns 1 if the repo has changes (0 if clean)

检查window$中的退出代码

echo %errorlevel% 
#returns 1 if the repos has changes (0 if clean) 

来自https://github.com/sindresorhus/pure/issues/115 感谢@paulirish 在该帖子上的分享

Answer 12

这是最好、最干净的方法。由于某种原因，所选答案对我不起作用，它没有选择暂存的未提交的新文件的更改。

function git_dirty {
    text=$(git status)
    changed_text="Changes to be committed"
    untracked_files="Untracked files"

    dirty=false

    if [[ ${text} = *"$changed_text"* ]];then
        dirty=true
    fi

    if [[ ${text} = *"$untracked_files"* ]];then
        dirty=true
    fi

    echo $dirty
}

Answer 13

如果在执行结束时有任何修改过的跟踪文件或任何未被忽略的未跟踪文件，我经常需要一种简单的方法来使构建失败。

这对于避免构建产生剩余的情况非常重要。

到目前为止，我最终使用的最佳命令如下所示：

 test -z "$(git status --porcelain | tee /dev/fd/2)" || \
     {{ echo "ERROR: git unclean at the end, failing build." && return 1 }}

它可能看起来有点复杂，如果有人找到短路变体，我将不胜感激 这保持了所需的行为：

• 如果一切正常，则无输出和成功退出代码
• 如果失败则退出代码 1
• stderr 上的错误消息解释了它失败的原因
• 显示导致失败的文件列表，再次stderr。

Answer 14

@eduard-wirch 的答案非常完整，但由于我想同时检查两者，这是我的最终变体。

        set -eu

        u="$(git ls-files --others)"
        if ! git diff-index --name-only --quiet HEAD -- || [ -z "${u:-}" ]; then
            dirty="-dirty"
        fi

当不使用 set -e 或等效项执行时，我们可以改为执行 u="$(git ls-files --others)" || exit 1（如果这适用于已使用的函数，则返回）

所以 untracked_files，只有在命令正确成功的情况下才会设置。

之后，我们可以检查这两个属性，并设置一个变量（或其他）。