如何配置Git忽略所有含.ipynb_checkpoints的文件?
解决Git追踪JupyterLab checkpoint文件的问题
直接通过修改.gitignore文件添加通用规则,就能让Git自动忽略所有相关的checkpoint文件,不用每次手动处理:
1. 项目级配置(仅当前项目生效)
找到项目根目录下的.gitignore文件(没有的话直接新建一个),添加以下两行规则:
# 忽略所有路径下的.ipynb_checkpoints目录及其中的所有文件 .ipynb_checkpoints/ # 忽略所有文件名包含-checkpoint的文件(适配各种后缀的checkpoint文件) *-checkpoint.*
这两行规则分别覆盖了两种情况:
- 第一种是JupyterLab生成的
.ipynb_checkpoints目录,不管它在项目的哪个子文件夹里,都会被Git忽略 - 第二种是单独的带
-checkpoint后缀的文件,比如你例子里的xxx-checkpoint.png、xxx-checkpoint.Rmd这类文件
2. 清除已被追踪的checkpoint文件
如果之前这些checkpoint文件已经被Git追踪过,需要先移除它们的追踪状态(不会删除本地文件):
执行以下命令:
# 移除所有.ipynb_checkpoints目录的追踪 git rm --cached -r .ipynb_checkpoints/ # 移除所有带-checkpoint的文件追踪 git rm --cached *-checkpoint.*
之后提交这个修改:
git add .gitignore git commit -m "更新.gitignore,忽略JupyterLab checkpoint文件"
3. 全局配置(所有Git项目通用)
如果你想让所有本地Git项目都自动忽略这些checkpoint文件,可以设置全局忽略规则:
- 在用户主目录下新建
.gitignore_global文件(Windows路径是C:\Users\你的用户名\.gitignore_global,Linux/macOS是~/.gitignore_global) - 同样添加上面的两行规则
- 执行命令让Git启用全局忽略:
git config --global core.excludesfile ~/.gitignore_global
内容的提问来源于stack exchange,提问作者Angus Campbell
相关产品推荐
相关产品推荐

