添加文件至Git索引时，如何覆盖Jupyter Notebook输出清理过滤器？

背景回顾 #

团队代码仓库中有大量Jupyter Notebook文件，因处理敏感数据，已通过以下配置实现提交时自动清理单元格输出：

1. 添加Git过滤器：
   git config filter.strip-notebook-output.clean 'jupyter nbconvert --ClearOutputPreprocessor.enabled=True --to=notebook --stdin --stdout --log-level=ERROR'
2. 在仓库.gitattributes中全局应用规则：
   *.ipynb filter=strip-notebook-output

需求实现方案 #

完全可以实现默认自动清理、特定场景保留输出的需求，以下两种方法分别适配长期和临时场景：

方法一：针对特定文件永久跳过过滤器（适合长期保留输出的Notebook） #

• 在仓库的.gitattributes文件末尾，添加目标文件的否定规则，示例：
  path/to/target-notebook.ipynb !filter
  （路径需准确，同目录文件直接写文件名即可）
• 执行命令让Git重新应用规则到目标文件：
  git add --renormalize path/to/target-notebook.ipynb
• 后续该文件提交时会自动保留输出，其他Notebook仍遵循默认清理规则

方法二：临时绕过过滤器添加文件（适合单次临时保留输出） #

• 确保目标Notebook已保存需要保留的输出内容
• 使用以下命令将文件添加至索引，强制跳过过滤器：
  git add --no-filter=strip-notebook-output path/to/target-notebook.ipynb
• 正常提交即可；下次提交该文件若需恢复自动清理，直接使用常规git add命令即可

验证建议 #

提交前可通过以下命令检查索引中的文件内容是否符合预期：
git diff --cached path/to/target-notebook.ipynb

内容的提问来源于stack exchange，提问作者3eyes