Git提示Jupyter notebook有未暂存变更但git diff无输出是什么原因？

这是Git针对.ipynb文件配置的自定义diff过滤规则导致的，常见的配置场景如下：

• 项目或全局Git配置了.ipynb专属的diff驱动，默认过滤notebook的metadata、execution_count等非核心内容的变更，避免运行notebook产生的无关修改干扰代码提交。
• 安装了nbdime等Jupyter专属的Git集成工具，这类工具默认会接管ipynb文件的diff输出，自动过滤非代码内容的变动。

规则验证方式 #

你可以通过以下两种方法确认过滤规则存在：

1. 查看项目根目录的.gitattributes文件，只要存在*.ipynb diff=ipynb这类配置，就说明绑定了自定义diff规则
2. 执行命令git config --get diff.ipynb.textconv，可以查看具体的过滤规则脚本内容

差异显示不一致的原因 #

直接执行git diff时会自动调用配置好的diff过滤规则，把被忽略的metadata变更从输出里剔除，所以看起来没有差异；而git add -p默认比对的是文件原始字节差异，不会应用diff文本转换过滤，所以能看到真实的变更内容。
如果需要跳过过滤规则直接查看原始差异，可以执行命令git diff --no-textconv。

无法消除修改提示的原因 #

只要你用Jupyter打开过该文件，Jupyter会自动更新cell的scrolled这类metadata字段，就算你用git restore、git reset等命令恢复到仓库版本，只要文件被Jupyter修改过，就会一直显示为modified状态。如果要彻底解决这个问题，可以给Jupyter配置关闭自动写入无用metadata的规则，或者在Git的clean过滤器里添加自动清除这类metadata的逻辑。

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