如何以编程方式确定是否存在未提交的更改？

在Makefile中，如果有未提交的更改（在工作树或索引中），我想执行某些操作。最干净，最有效的方法是什么？在一种情况下以零返回值而在另一种情况下以零返回值的退出命令将适合我的目的。

我可以运行git status输出并将其通过管道传输grep，但是我觉得必须有更好的方法。

UPDATE：在OP 丹尼尔Stutzbach指出，在评论这个简单的命令git diff-index为他工作：

git update-index --refresh 
git diff-index --quiet HEAD --

（nornagon提到的意见，如果有已经触及文件，但其内容是一样的指数，你需要运行git update-index --refresh之前git diff-index，否则diff-index会错误地报告树是脏）

如果在bash脚本中使用命令，则可以看到“ 如何检查命令是否成功？ ”：

git diff-index --quiet HEAD -- || echo "untracked"; // do something about it

注：如评论由安东尼Sottile

git diff-index HEAD ...将在没有提交的分支（例如新初始化的存储库）上失败。
我发现的一种解决方法是git diff-index $(git write-tree) ...

并haridsv指出在评论即git diff-files上一个新的文件，不检测它作为一个差异。
较安全的方法似乎是先git add在文件规范上运行，然后再git diff-index查看运行前是否将任何内容添加到索引中git commit。

git add ${file_args} && \
git diff-index --cached --quiet HEAD || git commit -m '${commit_msg}'

而6502在评论中报告：

我碰到的一个问题是，这git diff-index将告诉我们，除了文件的时间戳之外，实际上没有任何区别。
运行git diff一次即可解决问题（令人惊讶的是，git diff实际上确实更改了沙箱的内容，这意味着.git/index）

如果git 在docker中运行，也会出现这些时间戳问题。

原始答案：

“以编程方式”意味着从不依赖瓷器命令。
始终依靠管道命令。

另请参见“ 使用Git检查脏索引或未跟踪的文件 ”以了解替代方法（如git status --porcelain）

您可以从撰写本文时所写的新“ require_clean_work_tree函数 ”中获得启发；）（2010年10月上旬）

require_clean_work_tree () {
    # Update the index
    git update-index -q --ignore-submodules --refresh
    err=0

    # Disallow unstaged changes in the working tree
    if ! git diff-files --quiet --ignore-submodules --
    then
        echo >&2 "cannot $1: you have unstaged changes."
        git diff-files --name-status -r --ignore-submodules -- >&2
        err=1
    fi

    # Disallow uncommitted changes in the index
    if ! git diff-index --cached --quiet HEAD --ignore-submodules --
    then
        echo >&2 "cannot $1: your index contains uncommitted changes."
        git diff-index --cached --name-status -r --ignore-submodules HEAD -- >&2
        err=1
    fi

    if [ $err = 1 ]
    then
        echo >&2 "Please commit or stash them."
        exit 1
    fi
}

虽然其他解决方案非常彻底，但是如果您想要快速又脏的东西，请尝试以下操作：

[[ -z $(git status -s) ]]

它只是检查状态摘要中是否有任何输出。

git diff --exit-code如有任何更改，将返回非零值；git diff --quiet一样，没有输出。由于您要检查工作树和索引，因此请使用

git diff --quiet && git diff --cached --quiet

要么

git diff --quiet HEAD

任何人都会告诉您是否存在未提交的更改。

扩展@Nepthar的答案：

if [[ -z $(git status -s) ]]
then
  echo "tree is clean"
else
  echo "tree is dirty, please commit changes before running this"
  exit
fi

正如其他答案中所指出的那样，只要简单地执行以下命令即可：

git diff-index --quiet HEAD --

如果省略最后两个破折号，则如果文件名为，则命令将失败HEAD。

例：

#!/bin/bash
set -e
echo -n "Checking if there are uncommited changes... "
trap 'echo -e "\033[0;31mFAILED\033[0m"' ERR
git diff-index --quiet HEAD --
trap - ERR
echo -e "\033[0;32mAll set!\033[0m"

# continue as planned...

请注意：此命令将忽略未跟踪的文件。

我创建了一些方便的git别名来列出未暂存和暂存的文件：

git config --global alias.unstaged 'diff --name-only'
git config --global alias.staged 'diff --name-only --cached'

然后，您可以轻松地执行以下操作：

[[ -n "$(git unstaged)" ]] && echo unstaged files || echo NO unstaged files
[[ -n "$(git staged)" ]] && echo staged files || echo NO staged files

您可以通过在PATH被调用的某处创建脚本来使其更具可读性git-has：

#!/bin/bash
[[ $(git "$@" | wc -c) -ne 0 ]]

现在，以上示例可以简化为：

git has unstaged && echo unstaged files || echo NO unstaged files
git has staged && echo staged files || echo NO staged files

为了完整起见，以下是未跟踪和忽略文件的相似别名：

git config --global alias.untracked 'ls-files --exclude-standard --others'
git config --global alias.ignored 'ls-files --exclude-standard --others --ignored'

使用python和GitPython包：

import git
git.Repo(path).is_dirty(untracked_files=True)

如果存储库不干净，则返回True

这是最好，最干净的方法。

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
}