GIT库中禁止追踪文件变化的两种方式

关注

转载最新推荐文章于 2026-07-04 14:54:17 发布 2.5k 阅读 AI 写同款· GEO 优化 ›

别再只插线了！用示波器‘偷看’USB-C PD协议握手全过程（附BMC/4B5B编码解析）本文详细介绍了如何使用示波器捕获并解码USB-C PD协议的握手过程，包括BMC/4B5B编码的解析技巧。从硬件配置到波形分析，再到协议注入，为工程师提供了一套完整的实战解码手册，帮助深入理解PD协议的工作原理。阅读详情

在使用GIT库管理代码的时候，如果工程的编译配置不太合理，编译过程中生成的中间文件会和源代码混杂在一起，或者每次编译都会对某些文件都进行部分更新等。此类文件，往往会对GIT的add和commit操作造成麻烦，特别是当工程中大量存在此类文件时，在进行git add操作时，必需对需要更新的文件一个个单独add，这时真是费事费力，异常痛苦。当然，我们希望遇到每个工程都配置合理，避免上述问题。但是实际工作中，由于历史原因，或者是由于第三方代码的引入，上述问题似乎不可避免。
为了解决上述问题，GIT至少提供了两种方式来禁止追踪以上两类易变化但又不需要频繁check-in的文件，一种是大家熟悉的.gitignore文件，另一种是'git update-index'命令。下面详细描述两种方式的用法。

使用.gitignore文件

使用.gitignore的文件禁止GIT库追踪文件的方法比较简单，用起来很方便，网上的相关介绍也比较多。
比如说工程中有一个加入了一个第三方的源代码包，编译后生成的中间文件.o, .so, .a 文件均不需要添加到GIT库中进行管理，这时，只需要在第三方源代码包的顶级目录下加入一个.gitignore文件，填入如下过滤规则，即可忽略该目录下所有的.o, .so, .a文件：

*.o
*.a
*.so

如果是一个比较大的工程，难以在短时间内确定工程中所有中间生成文件的具体位置，那么也有快速解决问题的办法。我采用的方式如下：

Step 1: 取一个干净的初始GIT库；
Step 2: 编译整个工程；
Step 3: 在GIT库的根目录下，利用git clean -df命令查找出所有未被追踪的中间生成文件
```
git clean -df > untracked_file.log
```
此时得到的untracked_file.log中包含了编译过程中生成目录和文件，并且还都没有被check-in进GIT库中。untracked_file.log的内容大概如下：
```
......
Removing project/develop/extra/target/lib/htb.so
Removing project/develop/mm_test/bin.macan/
......
```
Step 4: 利用untracked_file.log 生成.gitignore（大家应该都能猜到该怎么做了)
编辑untracked_file.log, 查找所有的"Removing "字符串，替换为空，然后把文件改名为.gitignore即可。
```
project/develop/extra/target/lib/htb.so
project/develop/mm_test/bin.macan/
```
step 5: 把生成的.gitignore放在GIT库的根目录下，并上传至GIT库。
如上操作便可以禁止GIT追踪编译过程中的中间生成目录和文件。

利用'git update-index --assume-unchanged' 命令

当一个文件必需放进GIT库里，同时又不需要每次改动的时候都要在库中做更新的时候，.gitignore就派不上用场了。你可能疑惑，怎么会有这样的文件呢？
举个例子，比如说我的工程中有一个buildtime.h, 每次make的时候，makefile中会自动的调用脚本获取当前系统时间，并更新buildtime.h中关于BUILD_TIME的宏定义。这个文件必需放在库里，否则编译的时候会告诉你找不到头文件；同时，这个文件每次编译都会更新，但是根本不需要提交更新.(历史遗留代码)。
再举个例子，比如说，工程里包含了很多第三方的包，开发时从来不需要改动第三方的源代码，但是每次编译，第三方的源文件或多或少都会发生一些变化。这种情况其实比较常见，原因也比较多，但总之，第三方代码在编译的过程中发生的改动完全不需要被提交到库里。
以上两种情形，.gitignore是没法用的，却可以通过如下命令告诉本地GIT库，不必对指定的文件进行追踪：

git update-index --assume-unchanged project/buildtime.h

如果接手一个比较大的工程，里边有巨多此类的文件，该怎么处理，一个个都找出来吗？不用担心，我采用的方法如下:

step 1: 取一个干净的初始GIT库；
step 2: 编译整个工程；
step 3: 在GIT库的根目录下，利用git clean -df命令，清理掉所有的中间生成文件和目录（参考.gitignore技巧中的step 3);
step 4: 利用git status命令，获取modified文件列表；
```
git status > modified_file.log
```
modified_file.log的内容，通常如下:
```
......
#        modified:    project/buildtime.h
......
```
step 5: 编辑modified_file.log，生成disable_track.sh脚本。同样是对文件是查找，替换操作，最后生成如下的.sh脚本
```
#!/bin/bash
git update-index --assume-unchanged project/buildtime.h
......
```
通常，我还会再生成一个enable_track.sh脚本，作为disable_track.sh的反向操作，以备不时之需：
```
#!/bin/bash
git update-index --no-assume-unchanged project/buildtime.h
......
```
step 6: 在本地库中执行disable_track.sh脚本, 即可禁止本地库对指定的文件进行追踪。如果需要忽略文件巨多，这步操作耗时会比较久，好在只要执行一次就可以了。
step 7: 把刚生成的脚本上传到GIT库，通知团队其它成员执行。'git update-index‘ 可不比.gitignore，这个命令仅对本地库生效，所以需要上传到GIT库，让团队其它开发人员自己在本地库下执行脚本。

总结

我现在使用的GIT工程，每次编译后，大量存在上述两类文件。每次执行git add需要找到自己改动过的文件一个一个添加，实在是无法忍受，就花了点时间在工程里做了上述的处理，效果出奇的好，不但git add可以随便用了，而且，由于大量变化的文件不需要跟踪了，GIT add, commit的操作速度也提升了不少。