了解.gitignore掩蔽和git clean

Question

我真的很难理解.gitignore文件的工作原理...

这是我的文件的样子：

custom/history
cache
*.log
custom/modules/*/Ext
upload
sugar-cron*
custom/application/Ext
custom/Extenstion/modules/*/Ext/Language
!custom/modules/*/Language/cs_CZ.*
!custom/modules/*/Language/en_us.*
custom/Extenstion/application/Ext/Language
!custom/Extenstion/application/Ext/Language/cs_CZ.*
!custom/Extenstion/application/Ext/Language/en_US.*
.htaccess
config.php
config_override.php
files.md5

这就是我的git状态：

apache@cb772759c68a sugarcrm$ git status
# On branch master
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#
#    LOG.txt
#    deploy_backup/
nothing added to commit but untracked files present (use "git add" to track)

因此，现在我想摆脱这两个未跟踪的文件，但令我惊讶的是，一大堆其他文件也被删除了。

apache@cb772759c68a sugarcrm$ git clean -fd
Removing Disabled/upload:/
Removing LOG.txt
Removing custom/Extension/modules/Bugs/Ext/Language/
Removing custom/Extension/modules/Cases/Ext/Language/
Removing custom/Extension/modules/EmailAddresses/
Removing custom/Extension/modules/EmailParticipants/
Removing custom/Extension/modules/ForecastManagerWorksheets/
Removing custom/Extension/modules/ForecastWorksheets/
Removing custom/Extension/modules/Forecasts/
Removing custom/Extension/modules/Meetings/Ext/Layoutdefs/
Removing custom/Extension/modules/Meetings/Ext/WirelessLayoutdefs/
Removing custom/Extension/modules/Meetings/Ext/clients/
Removing custom/Extension/modules/ModuleBuilder/
Removing custom/Extension/modules/OutboundEmail/
Removing custom/Extension/modules/PdfManager/
Removing custom/Extension/modules/ProjectTask/Ext/Language/
Removing custom/Extension/modules/Quotas/
Removing custom/Extension/modules/Quotes/Ext/Dependencies/
Removing custom/Extension/modules/Targets/
Removing custom/Extension/modules/Tasks/Ext/Language/
Removing custom/Extension/modules/TimePeriods/
Removing custom/application/
Removing custom/install/
Removing custom/modules/Administration/
Removing custom/modules/Bugs/
Removing custom/modules/Cases/
Removing custom/modules/Contracts/
Removing custom/modules/Emails/
Removing custom/modules/HHP_Products/
Removing custom/modules/KBContents/
Removing custom/modules/Project/
Removing custom/modules/ProjectTask/
Removing custom/modules/ProspectLists/
Removing custom/modules/Prospects/
Removing custom/modules/Quotas/
Removing custom/modules/Reports/
Removing custom/modules/RevenueLineItems/
Removing custom/modules/Schedulers/
Removing custom/modules/Tags/
Removing custom/modules/Teams/
Removing custom/modules/hhp_assignment_zip/
Removing custom/modules/hhp_zipcode/
Removing custom/working/modules/Calls/
Removing custom/working/modules/Leads/clients/
Removing deploy_backup/
Removing deploy_log/
Removing dist/identity-provider/tests/docker/saml-test/config/simplesamlphp/config/
Removing vendor/sugarcrm/identity-provider/tests/docker/saml-test/config/simplesamlphp/config/

第一点-删除后的文件在git status之后没有显示，因此显然它们是gitignore“ mask”的一部分...谁能解释，这些文件中的任何一个与gitignore中的任何模式如何匹配？ 像vendor/sugarcrm/identity-provider/tests/docker/saml-test/config/simplesamlphp/config/ 。有人可以帮助我构建适当的gitignore吗？

第二点-我认为.gitignore可以从git clean “保护”这些未版本控制的文件，而git实际上不会对它们采取任何措施。 所以很明显它确实删除了它们...在使用git clean时如何删除未版本控制的文件？

编辑：我混淆git clean与git rm，我一直在谈论git clean

编辑2：事实证明，与.gitignore不匹配的已删除目录毕竟是“空”的。 （它们有子目录，但是目录树没有任何文件...）

Answer 1

TL; DR

您误解了git clean默认情况下使用-d删除的内容。 （注意：我自己不是git clean忠实git clean ；要删除珍贵的文件太容易了。）

长

如phd所述 ，在.gitignore列出文件特别是默认情况下会禁用 git clean清除文件。 但是， git clean比这要复杂得多。 我们将对此进行讨论。

不过，首先让我们解决.gitignore项的一个特殊性。 如果您已经了解了所有这些信息（但似乎没有人知道:-)），则可以跳到下面的git clean -specific部分。

1. 跟踪的文件（当前位于索引中）永远不会被忽略，因此匹配.gitignore或等效文件（例如.git/info/exclude ）模式是无关紧要的。

   这句话用在指数现在意味着这一点。 当您使用git add或git rm --cached添加或删除文件时，这会改变其跟踪度。 您还可以使用git ls-files --stage转储索引中每个文件的完整列表及其暂存数据（模式，哈希和stage-slot-number），或者不使用--stage仅获取名称。

2. 由Git找到的文件 （不是目录），当前不在索引中，将被取消跟踪 。 Git不存储目录，因此目录永远不会出现在索引中。 ¹跟踪或未跟踪纯粹是文件的属性。

3. 未跟踪的文件也可以是忽略的文件。 如果是这样， git add不会增加它，即使你明确地将其命名为在命令行上（尽管你既可以明确地命名， 并使用--force添加它）。

   这意味着文件（而非目录）属于以下三类之一：已跟踪，未跟踪（仅）或未跟踪且被忽略。 这对于git status重要， git status只抱怨未跟踪的文件（不是未跟踪和忽略的文件），还有一点是git clean 。

4. 最后，当Git执行完整的目录树搜索/扫描时（如git add . 例如，遇到一个可能会跳过的目录（其中没有跟踪文件），Git将检查目录本身是否与.gitignore模式匹配，如果匹配， 则不查看其内部。 这可以加快git status和git add -A / git add . 在这样的目录上（例如，如果您可以忽略整个供应商树或SDK，则有时会很大）。

第4条是为什么，如果你想不能忽视一些生活的目录路径下特定的文件路径，必须指示Git的具体未忽略的目录。 如果您忽略目录，则Git可能永远都不会在目录中查找。 这会特别影响以下三行：

custom/Extenstion/application/Ext/Language
!custom/Extenstion/application/Ext/Language/cs_CZ.*
!custom/Extenstion/application/Ext/Language/en_US.*

如果您忽略了整个目录custom/Extenstion/application/Ext/Language ，那么Git将不会在其中查找内容，也永远不会找到与custom/Extenstion/application/Ext/Language/cs_CZ.*相匹配的文件来忽略它。 因此，有必要将目录本身从忽略状态中custom/Extenstion/application/Ext/Language/* ：您应该将第一行更改为custom/Extenstion/application/Ext/Language/* ，以便Git必须在目录内部查看。 以cs_CZ.*和en_US.*结尾的后续行将覆盖捷克语文件和美国英语文件的忽略状态。

---

¹实际上，它们可以出现在索引中，但只能被视为特殊情况。 git ls-files可以显示索引内容，直接跳过它们。

---

使用git clean -d明显修改规则4

如果目录为空， Git只能删除它。 这是操作系统强制执行的一般规则：如果目录d包含一些文件d/f1 ， d/f2等，而您要删除d而没有先删除文件，则文件会出现问题。 系统会强制您首先删除目录中的文件。 这也适用于子目录：即使d/sub本身是一个空目录，如果d/sub存在，也无法删除d 。 只能删除空目录。

在没有-d情况下运行git clean不仅会保留规则4的安装，而且实际上会对其进行扩展 。 例如，在我们开始的示例中，Git注意到（1） custom/Extenstion/application/Ext/Language是目录； （2）目录匹配忽略模式； 所以（3） 只要是没有文件 custom/Extenstion/application/Ext/Language那些已经跟踪的Git能够而且将会跳过整个目录（当然不是因为删除它， git clean而不运行-d ）。

假设还有一个名为xyzzy/的目录，该目录中没有列出文件。 该目录可能完全为空。 在这种情况下，根据定义，其中没有未跟踪的文件； 所以没有-d git clean应该什么都不做。 或者它可能有文件； 这些文件是由定义未跟踪（因此可能未跟踪和被忽视），但你说不要删除目录，这样git clean 还是根本不屑进去看看。 这是一个有点奇怪的情况： Git常常不费心去查看未知目录。 ² （您也看到了git status ：您必须使用git status -uall在一个神秘目录中查找文件 。但是git add -A或git add .必须在内部查看， 除非忽略该目录，这是为什么规则4在一般情况下有点复杂。）

但是，使用-d运行显然会完全排除规则4。 同样，为了删除目录，Git必须首先删除目录中的所有文件。 为此，Git还必须枚举内容。 因此，如果您告诉git clean使用-d ，似乎完全禁用规则4是合适的。 路径名的目录性将强制Git扫描目录的内容。 因为已经有了跟踪的文件，我们要么已经需要向内看，要么为了删除目录而需要向里看以删除文件。

---

²请注意，“未知”与“未跟踪”不同。 它甚至不是Git术语； 我在这里整理的。 但是，正如我们将看到的，如果Git 确实定义了短语“未跟踪的目录”，那就更好了。

---

git clean删除了什么

运行git clean -n将向您显示它将删除的内容。 该显示使用了一些简写形式：删除目录意味着删除该目录中的所有文件，包括（递归）带有子文件的子目录。 这比使用-f而不是-n更为安全，因为-f向您显示了其删除的内容，因此-n向您显示了将删除的内容。

默认情况下， git clean会删除未跟踪的文件， 但不会删除未被跟踪和忽略的文件。 也就是说，回到上面的第3点，查看文件的三个分类： git clean除去中间分类（仅）。 添加-X （大写X）告诉Git： 不要删除未跟踪的文件；不要删除未跟踪的文件。 相反，请删除未跟踪和忽略的文件。

添加-x告诉Git： 不要读取通常的忽略指令文件，如.gitignore 。 此时，将不会忽略任何文件，因此（无论跟踪哪个文件）都无法取消跟踪和忽略文件。 将其与-X组合将毫无意义，因此³ git clean禁止同时使用-x和-X 。

使用-d运行git clean可以删除空目录。 在这里，事情变得尤为怪异。 好像Git的跟踪，未跟踪和未跟踪且被忽略的分类有点崩溃了。 该文档说-d将：

除未跟踪的文件外，还删除未跟踪的目录。

但是Git没有未跟踪目录的定义。 “ Tracked-ness”仅是files的属性。 我们确实在脚注中看到目录作为不可见的实体潜入索引中（以加快各种Git操作的目的），但这并不意味着要跟踪目录。

我们可以弥补：“未跟踪的目录”可能是不包含跟踪文件的目录。 我认为（但尚未证明自己满意）该定义有效并解释了git clean的行为。 但是，如果Git文档正确定义了此定义，将会很有帮助。

---

³将-x和-X与-e结合使用可能会有一些实际用途，但是Git仍然禁止这样做，至少到今天为止。

Answer 2

1. .gitignore忽略文件的添加和提交。 正相反，它不能保护它们免于清洗。

2. 这些清除的文件与.gitignore的关联方式如下：

   自定义/扩展名/模块/错误/扩展名/语言/自定义/扩展名/模块/案例/扩展名/语言/

匹配custom/modules/*/Ext规则。

LOG.txt
vendor/sugarcrm/identity-provider/tests/docker/saml-test/config/simplesamlphp/config/

文件未添加到索引中，因此可以清除。

3. 为了避免清理未版本控制的文件，请不要运行git clean 。 手动删除不需要的文件。