如何在Git克隆时自动配置gitattributes中的过滤器驱动命令？

问题背景 #

我用了Stack Overflow高赞回答里的ipynb笔记本过滤策略，已经在仓库的.gitattributes里配了：

*.ipynb filter=strip-notebook-output

本地.git/config里的过滤器命令是：

[filter "strip-notebook-output"]
        clean = """jupyter nbconvert --ClearOutputPreprocessor.enabled=True --ClearMetadataPreprocessor.enabled=True --ClearMetadataPreprocessor.preserve_nb_metadata_mask=\"kernelspec\" --to=notebook --stdin --stdout --log-level=ERROR"""

这套配置用着没问题，但其他人克隆仓库后得手动加.git/config里的配置，太麻烦，想找个能自动生效的简便方法。我自己想了几个方向：

• 自动把配置加到.git/config
• 把完整命令写到.gitattributes里
• 用nbstripout库替代长命令（需要安装）
• 用Git模板目录（操作太复杂，不适合这个单行命令场景）

可行方案推荐 #

方案一：脚本一键配置（无额外依赖） #

直接写个简单脚本，让用户克隆后跑一下就自动配置好.git/config，步骤如下：

1. 在仓库根目录新建setup-ipynb-filter.sh文件，内容：

#!/bin/bash
git config filter.strip-notebook-output.clean 'jupyter nbconvert --ClearOutputPreprocessor.enabled=True --ClearMetadataPreprocessor.enabled=True --ClearMetadataPreprocessor.preserve_nb_metadata_mask="kernelspec" --to=notebook --stdin --stdout --log-level=ERROR'
echo "ipynb输出过滤配置已搞定"

2. 给脚本加执行权限：

chmod +x setup-ipynb-filter.sh

3. 在README里加一句提示：克隆后执行./setup-ipynb-filter.sh即可完成配置。

这种方式简单直接，不需要用户手动复制粘贴长命令，也不用装额外工具。

方案二：用nbstripout库（更简洁可靠） #

nbstripout是专门处理ipynb Git过滤的工具，配置比自己写长命令省心：

1. 先安装nbstripout：

pip install nbstripout

2. 在仓库根目录执行初始化命令，它会自动帮你配置.gitattributes和本地.git/config：

nbstripout --install --attributes .gitattributes

3. 把更新后的.gitattributes提交到仓库，里面会是：

*.ipynb filter=nbstripout

其他用户克隆后，只需要装nbstripout，再执行nbstripout --install就能自动配好过滤器，比自己写命令不容易出错。

不可行/不推荐的方案 #

• 把完整命令写到.gitattributes：Git不支持在.gitattributes里直接定义过滤器的具体执行命令，只能指定过滤器名称，所以这个路子走不通。
• Git模板目录：模板是全局设置，没法绑定到单个仓库，操作复杂还不适合团队共享，没必要折腾这个。

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