Git 常用命令（十三）—— Git 取消文件更新监听【转载】

平常使用 pm2 启动 node 项目时，想要指定日志输出地址，需要创建好日志文件，但是又不想打印的日志页传到仓库，可以新创建日志文件，提交后在忽略该文件的更新监听。

¶为什么要取消文件监听

取消文件监听自有它的好处，比如平时开发你可以使用自己的脚本对项目进行更改、打补丁、等等。最常见的手段就是直接修改项目的配置文件.gitignore，然后写上你要忽略的文件，比如：

node_modules/
dist/
test/
config/index.js

但问题来了，.gitignore的修改会被 git 监听到，如果你不介意的话，那么到这里就结束了，但如果你也不想要.gitignore也被监听到，那就继续往下看。

¶一、assume-unchanged 和 skip-worktree

使用assume-unchanged

1
2
3

git update-index --assume-unchanged 指定你的文件
// 例如
git update-index --assume-unchanged ./config/index.js

此时放心的去修改./config/index.js，你会看到 git 不再去监听它，达到了不改.gitignore的的情况下也能取消监听。

使用skip-worktree

1
2
3

git update-index --skip-worktree 指定你的文件
// 例如
git update-index --skip-worktree ./config/index.js

也是一样，放心的去修改./config/index.js

如果你想恢复监听可以输入：

1 2	git update-index --no-assume-unchanged 文件名 git update-index --no-skip-worktree 文件名

如果你想列出哪些文件使用过assume-unchanged或skip-worktree，可以输入：

1 2	git ls-files -v\|grep "^h" git ls-files -v\|grep "^S"

¶`assume-unchanged`与`skip-worktree`有什么区别

这两种方式效果功能一样，笔者的初略理解是使用pull时有细微差别

--assume-unchanged pull 时，如果远程文件发生与你的取消监听文件有发生了冲突，git 会以远程文件为最新进行覆盖掉旧的，则原先的取消监听文件会失效。
--skip-worktree pull 时，git 会尽力维护你的取消监听文件，确保它们不会被某些情况给覆盖掉，最多就会提示你冲突了，让你手动解决。

结合以上笔者建议使用skip-worktree会更稳妥些。

¶二、配置当前项目的`.git\info\exclude`文件

如果项目没看到有.git目录说明是被隐藏掉了，可以通过【查看】进行设置显示，编辑exclude文件跟编辑.gitignore一样：

node_modules/
dist/
test/
config/index.js

OK，就是这么简单！

¶三、全局配置`.gitignore_global`文件

1
2
3

cd ~
touch .gitignore_global
git config --global core.excludesfile ~/.gitignore_global

解释：

1、cd ~表示切换到用户目录
2、touch .gitignore_global表示新建.gitignore_global文件
3、最后进行 git 配置
4、.gitignore_global文件通常放在C:\Users\用户名下面
5、.gitignore_global文件编辑规则和上面一样

node_modules/
dist/
test/
config/index.js

这样所有项目就都会生效这套规则啦~

¶注意事项

以上的任意方式当切换分支时会出现一种特殊情况：即你的取消监听文件（比如 index.js）是项目现有的，然后你对它进行了更改而且 git 也忽略了它，但是当你切换分支时，如果切换分支的（index.js）与当前分支的 index.js 文件有冲突，你是无法切换过去的，它会提示如下：

图中表示config/index.js会被即将到来的分支所覆盖，请在切换分支前进行提交。

因为这个问题笔者也是花费了很多时间去找答案，最终能找到的解决手段是：

1、恢复监听
2、使用 stash 保留数据然后切换分支
3、stash pop 恢复数据
4、重新取消监听

命令如下：

git update-index --no-skip-worktree ./config/index.js
git stash
git checkout 分支名
git stash pop
git update-index --skip-worktree ./config/index.js

虽然繁琐了点，但起码这是目前唯一的手段，因此笔者建议要取消监听的文件最好是新建的，而不是现有的，这样切换不同分支时就不会出现这样的问题，当然也有可能切换的分支刚好跟你新建的文件是相同的那么还是会产生上面情况，总之尽量少对现有的文件进行取消跟踪，因为 git 不知道切换下一个分支时，到底是忽略还是监听。

关于使用哪种方式来取消文件监听笔者最喜欢的当然是第二和第三种，简单省事 ~

¶参考资料

1、Git 取消 git 文件跟踪/监听的几种方式及注意事项
2、删除 git 仓库中无用大文件