Git 命令显示 .gitignore 忽略了哪些特定文件

Question

我正在接触 Git，并遇到以下问题：

我的项目源树：

/
|
+--src/
+----refs/
+----...
|
+--vendor/
+----...

我的供应商分支中有代码（当前为 MEF），我将在那里进行编译，然后将引用移至 /src/refs 这是项目从中获取它们的地方。

我的问题是我将 .gitignore 设置为忽略 *.dll 和 *.pdb。 我可以执行 git add -f bar.dll 来强制添加被忽略的文件，这是可以的，问题是我无法弄清楚列出哪些文件存在被忽略。

我想列出被忽略的文件，以确保我不会忘记添加它们。

我已阅读 git ls-files 上的手册页，但无法使其工作。 在我看来， git ls-files --exclude-standard -i 应该做我想做的事。 我缺少什么？

Answer 1

注：

• 小白的答案 更简单（git1.7.6+）：git status --ignored
  （详见“有没有办法告诉 git-status 忽略 .gitignore 文件的影响？”）

---

也很有趣（在 qwertymk的答案），您也可以使用 git check-ignore -v 命令，至少在 Unix 上（在 CMD Windows 会话中不起作用，但在 Windows CMD git bash 会话中起作用）

git check-ignore -- *
git check-ignore -v -- *

第二个显示.gitignore 的实际规则使文件在 git 存储库中被忽略。
在 Unix 上，使用“什么递归地扩展到当前目录中的所有文件?" 和 bash4+:

git check-ignore **/*

（或 find -exec 命令）

注意：https:// /stackoverflow.com/users/351947/Rafi B. 建议 在评论中避免（有风险的）globstar：

git check-ignore -v $(find . -type f -print)

确保从 .git 中排除文件/ 子文件夹。

CervEd 在 注释，以避免 .git/：

find . -not -path './.git/*' | git check-ignore --stdin

---

原始答案（2009）

git ls-files -i

应该有效，除了其源代码表示：

if (show_ignored && !exc_given) {
                fprintf(stderr, "%s: --ignored needs some exclude pattern\n",
                        argv[0]);

exc_given？

事实证明，在 -i 之后还需要一个参数才能实际列出任何内容。

尝试：（

git ls-files -i --exclude-from=[Path_To_Your_Global].gitignore

但这只会列出您的缓存（非忽略）对象，并带有过滤器，因此这并不完全是您想要的）

---

示例：

$ cat .git/ignore
# ignore objects and archives, anywhere in the tree.
*.[oa]
$ cat Documentation/.gitignore
# ignore generated HTML files,
*.html
# except foo.html which is maintained by hand
!foo.html
$ git ls-files --ignored \
    --exclude='Documentation/*.[0-9]' \
    --exclude-from=.git/ignore \
    --exclude-per-directory=.gitignore

---

实际上，在我的“gitignore”文件中（称为“排除'），我找到一个可以帮助您的命令行：

F:\prog\git\test\.git\info>type exclude
# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~

所以......

git ls-files --ignored --exclude-from=.git/info/exclude
git ls-files -i --exclude-from=.git/info/exclude

git ls-files --others --ignored --exclude-standard
git ls-files -o -i --exclude-standard

应该可以解决问题。

（感谢honzajde指出在注释中 git ls-files -o -i --exclude -from... 不不包含缓存文件：仅git ls-files -i --exclude-from...（不包含< /em> -o) 确实如此。)

正如 ls-files 手册页，--others 是重要部分，向您展示非缓存、非提交、通常被忽略的文件。

--exclude_standard 不仅仅是一个快捷方式，而且是一种包含所有标准“忽略模式”设置的方法。

排除标准
在每个目录中添加标准 git 排除：.git/info/exclude、.gitignore，以及用户的全局排除文件。

---

Git 2.44（2024 年第 1 季度），第 13 批，澄清了文档，其中 - -exclude-per-directory 选项被标记为已弃用，这让读者误以为将来可能有计划删除它，但这不是我们的意图。

请参阅 提交 0009542（2024 年 1 月 24 日），作者：Junio C Hamano (gitster)。
^{（由 Junio C Hamano -- gitster -- 合并于 提交 bbc8c05，2024 年 2 月 2 日）}

ls-files：避免动词“deprecate” “对于个别选项

当e750951（“ls-files：指南人们使用 --exclude-standard 而不是其他 --exclude* 选项”，2023-01-13，Git v2.40.0-rc0 -- 合并 在批次#中列出13）更新了文档以提高 --exclude-standard 选项的可见性，它将 --exclude-per-directory 选项标记为“已弃用” ”。

虽然从技术上讲，被弃用并不一定意味着计划稍后将其删除，但它似乎会给读者带来困惑，尤其是当我们仅仅指的是

选项Y可以用来实现与选项相同的效果 
  X 更简单。   对于那些对两者都不熟悉的人 
  X或Y，我们建议在适当的时候使用Y。 
  

对于 --exclude-standard 与更细粒度的 --exclude-from 和 --exclude-per-directory 的组合来说尤其如此< /code> 选项。
确实，仅通过给出前者就可以获得细粒度选项的一种常见组合，但这并不一定意味着不需要更细粒度的控制。

在--exclude-per-directory的描述中说明我们推荐读者--exclude-standard的原因，而不是说该选项已被弃用。
另外，请详细说明模拟 --exclude-standard 的作用，以便用户可以对其进行细微的调整（例如“与 Git Porcelain 执行相同的操作，除非我不想阅读core.excludes 中的全局排除文件”）。

git ls-files 现在包含在其 手册页：

中的目录及其子目录。 如果你是
尝试模仿 Porcelain 命令的工作方式，使用
--exclude-standard 选项反而更简单、更多
彻底。

git ls-files 现在包含在其 手册页：

通常，当您
希望排除规则的应用方式与 Porcelain 相同
命令可以。 要模拟 --exclude-standard 指定的内容，您
可以给出--exclude-per-directory=.gitignore，然后指定：

1. 由core.excludesfile配置指定的文件
   变量（如果存在）或 $XDG_CONFIG_HOME/git/ignore 文件。

2. $GIT_DIR/info/exclude 文件。

通过 --exclude-from= 选项。

Answer 2

有一个更简单的方法来做到这一点（git 1.7.6+）：

git status --ignored

请参阅 有没有办法告诉 git-status 忽略.gitignore 文件的影响？

Answer 3

另一个非常干净的选项（没有双关语。）：

git clean -ndX

说明：

$ git help clean

git-clean - Remove untracked files from the working tree
-n, --dry-run - Don't actually remove anything, just show what would be done.
-d - Remove untracked directories in addition to untracked files.
-X - Remove only files ignored by Git.

注意：此解决方案不会显示已被删除的忽略文件。

Answer 4

虽然通常是正确的，但您的解决方案并不在所有情况下都有效。
假设 repo 目录像这样：

# ls **/*                                                                                                       
doc/index.html  README.txt  tmp/dir0/file0  tmp/file1  tmp/file2

doc:
index.html

tmp:
dir0  file1  file2

tmp/dir0:
file0

和 .gitignore 像这样：

# cat .gitignore
doc
tmp/*

这会忽略 doc 目录和 tmp 下面的所有文件。
Git 按预期工作，但列出被忽略文件的给定命令却没有。
让我们看看 git 怎么说：

# git ls-files --others --ignored --exclude-standard                                                            
tmp/file1
tmp/file2

请注意，列表中缺少 doc。
您可以通过以下方式获取它：

# git ls-files --others --ignored --exclude-standard --directory                                                
doc/

注意附加的 --directory 选项。

据我所知，没有一个命令可以一次性列出所有被忽略的文件。
但我不知道为什么tmp/dir0根本不显示。

Answer 5

Git 现在内置了此功能

git check-ignore *

当然，您可以在您的情况下将 glob 更改为 **/*.dll

Git 参考

Answer 6

以下是如何打印工作树中与 Git 的多个 gitignore 源中任意位置的模式相匹配的文件的完整列表（如果您使用的是 GNU find）：

$ cd {your project directory}
$ find . -path ./.git -prune -o -print \
| git check-ignore --no-index --stdin --verbose

它将检查当前分支中的所有文件存储库的（除非您已在本地删除它们）。

它还标识了特定的 gitignore 源代码行。

Git 继续跟踪某些与 gitignore 模式匹配的文件中的更改，只是因为这些文件已被添加。 有用的是，上面的命令也显示这些文件。

负的 gitignore 模式也被匹配。 但是，这些在列表中很容易区分，因为它们以 ! 开头。

如果您使用的是 Windows，Git Bash 包含 GNU find (正如 find --version 所揭示的那样）。

如果列表很长（并且您有 rev），您也可以通过扩展名（某种程度上）显示它们：

$ cd {your project directory}
$ find . -path ./.git -prune -o -print \
| git check-ignore --no-index --stdin --verbose \
| rev | sort | rev

有关更多详细信息，请参阅 man find、man git-check-ignore、man rev 和 man sort。

整个方法的要点是 Git（软件）正在快速变化并且非常复杂。 相比之下，GNU 的 find 极其 稳定（至少在此处使用的功能方面是如此）。 因此，任何希望通过展示自己对 Git 的深入了解来提高竞争力的人都会以不同的方式回答这个问题。

最好的答案是什么？ 这个答案故意最小化对 Git 知识的依赖，通过模块化（信息隔离）来实现稳定和简单的目标，并且被设计为可以持续很长时间。

Answer 7

使用它应该足够了，

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

因为它涵盖了所涵盖的所有内容，

git ls-files --others -i --exclude-from=.git/info/exclude

因此后者是多余的。

---

You can make this easier by adding an alias to your ~/.gitconfig file:

git config --global alias.ignored "ls-files --others -i --exclude-standard"

现在您只需输入 gitignoreed 即可查看列表。 更容易记住，打字也更快。

如果您更喜欢 Jason Geng 的解决方案的更简洁显示，您可以为其添加一个别名，如下所示：

git config --global alias.ignored "status --ignored -s"

然而，更详细的输出对于解决 .gitignore 文件的问题更有用，因为它列出了每个单独的棉花采摘文件被忽略。 您通常会通过 grep 传送结果，以查看其中是否存在您希望忽略的文件，或者是否存在您不想忽略的文件。

git ignored | grep some-file-that-isnt-being-ignored-properly

然后，当您只想看到简短的显示时，很容易记住和键入

git status --ignored

（通常可以省略 -s。）

Answer 8

如果您只需要有效的文件列表忽略（无论它们如何被忽略），并且没有任何额外的通知和日志。

一旦创建，任何地方（在Git-bash中） ) run：

git ignore-list

通过执行以下命令创建它：

git config --global alias.ignore-list "! cd -- \"\${GIT_PREFIX:-.}\" && git ls-files -v \${1:-.} | sed -n -e \"s,^[a-z] \(.*\)$,\${GIT_PREFIX:-./}\1,p\" && git status --ignored --porcelain \${1:-.} 2>/dev/null | sed -n -e \"s/^\(\\!\\! \)\(.*\)$/\2/p\" #"

使用示例，
假设这是初始提交并且您想要推送所有内容，请尝试：

git 忽略列表 |   xargs git add -f 
  

注意：

1. 它已经过测试并且可以在 macOS 和 Windows 平台上运行！
2. 一旦您 cd 进入某个目录，仅列出该目录（或其子目录）中忽略的文件。
3. 最后，始终记录相对于 root-dir 的路径（其中包含 .git 目录，无论您 cd 进入哪个目录）。

另一个有用的东西是人类可读性，就像如果忽略整个目录，例如 build 或 node_modules，这将仅记录目录名称。
而 git ls-files --others -i --exclude-standard 命令会记录每个文件（适用于 xargs ）。

Answer 9

我只想

git status --porcelain --ignored

列出被忽略的文件

git status --porcelain --ignored | grep '^[!][!] '

Answer 10

您可以使用 fd。

运行的命令是：

comm -23 <(fd -HI | sort) <(fd -H | sort) 

请注意，如果没有 .git 目录，只有 .gitignore 文件（例如裸存储库），您必须具体说明位置.gitignore 文件是。

comm -23 <(fd -HI | sort) <(fd -H --ignore-file .gitignore | sort)

更具体地说，请使用 --no-ignore-vcs 而不是 -I

有关更多详细信息，请查看 此处。

Answer 11

假设有一些忽略目录，为什么不使用“git status node/logs/”来告诉您要添加哪些文件？ 在目录中，我有一个不属于状态输出的文本文件，例如：

Onbranchmaster
您的分支已更新为“origin/master”。
未跟踪的文件：
（使用“git add ...”包含在将提交的内容中）

    node/logs/.gitignore 

.gitignore 是：

*

!.gitignore

Answer 12

_{（扩展其他答案）}

注意，git check-ignore 使用提交的 .gitignore 而不是工作树中的！ 要在不污染 git 历史记录的情况下使用它，您可以自由地尝试编辑它，然后使用 git commit --amend 进行提交。

这个问题主要发生在您需要解决问题的方法时，即 git 不跟踪目录。 在.gitignore中输入：

dirtokeep/**
!dirtokeep/.keep

.keep应该是dirtokeep中的零长度文件。

结果将是 dirtokeep 中的所有内容都将被忽略，除了 dirtokeep/.keep，这将导致dirtokeep 目录也将在克隆/签出时构建。