如何在git add和commit流程中临时绕过clean过滤器

Git本身并没有提供git add或git commit的直接选项来单次跳过clean过滤器——因为clean过滤器是在git add将工作区文件内容存入暂存区时触发的，设计上是基于路径或全局的配置规则，没有专门的单次临时禁用开关。不过可以通过以下两种临时修改配置的方式实现需求：

方法1：临时修改.gitattributes规则 #

1. 打开仓库根目录的.gitattributes文件，找到对应Jupyter Notebook的过滤规则（比如*.ipynb filter=clean_ipynb），把它改成*.ipynb -filter（直接取消该文件类型的过滤器），或者用#注释掉这一行。
2. 执行git add your_notebook.ipynb，此时clean过滤器不会对这个文件生效，原始内容会被存入暂存区。
3. 把.gitattributes改回原来的状态，避免影响后续的提交操作。
4. 正常执行git commit完成提交。

方法2：临时覆盖过滤器的clean命令 #

1. 假设你的clean过滤器名称是clean_ipynb，执行以下命令临时清空它的clean指令：

   git config --local filter.clean_ipynb.clean ""
   

2. 执行git add your_notebook.ipynb，此时过滤器不会执行任何清理操作。
3. 恢复原来的clean命令配置（把""替换成你原本的清理脚本/命令）：

   git config --local filter.clean_ipynb.clean "你的原始清理命令"
   

4. 执行git commit完成提交。

补充说明 #

你之前考虑的两个方案不符合需求的原因：

• git add --renormalize是强制对文件重新应用过滤器规则，和你想要绕过的需求完全相反；
• 你参考的Stack Overflow问题聚焦于checkout、stash pop等场景的过滤器禁用，和add→commit的工作流逻辑不同，因此无法复用。

内容的提问来源于stack exchange，提问作者Joshua Shew