Modèle .gitignore Jupyter Notebooks expliqué
Explique pourquoi JupyterNotebooks.gitignore ignore .ipynb_checkpoints, les profils IPython et .virtual_documents, et comment gérer les sorties des notebooks.
JupyterNotebooks.gitignore est un court modèle du dossier community du dépôt de modèles ; il ne traite que les fichiers que Jupyter et IPython créent à côté des notebooks. Il ne couvre ni les environnements virtuels ni __pycache__ : utilisez-le avec le modèle Python.
Les résultats d'exécution et les images enregistrés dans le fichier notebook (.ipynb) ne relèvent pas de gitignore. C'est une question de contenu de fichier, et non de fichier entier : elle se traite avec un outil séparé.
Explication règle par règle
| Motif | Ce qui est ignoré et pourquoi |
|---|---|
.ipynb_checkpoints*/.ipynb_checkpoints/* | Points de contrôleCopies que Jupyter crée dans chaque dossier contenant un notebook lors de l'enregistrement automatique. La première ligne capture les dossiers de points de contrôle à toute profondeur, la seconde capture explicitement le contenu de ceux situés un niveau plus bas. |
profile_default/ipython_config.py | Configuration IPythonDossiers de profils et fichiers de configuration IPython ; ils peuvent contenir des informations personnelles, comme la base de données de l'historique d'exécution. |
.virtual_documents/ | JupyterLab LSPDossier de documents virtuels créé par l'extension jupyterlab-lsp pour transmettre les notebooks au serveur de langage. |
Points d'attention en pratique
- Pour ne pas commiter les sorties des notebooks, installez
nbstripoutcomme filtre git, ou prenez l'habitude d'effacer les sorties avant chaque commit. - Ce modèle ne bloque pas les gros fichiers de données (
data/,*.csv,*.parquet). Si nécessaire, ajoutez-les vous-même ou utilisez DVC ou Git LFS. - Si vous placez des clés d'API dans
.envet les lisez depuis un notebook, vous avez aussi besoin de la règle.envdu modèle Python.
Modèle d'origine
# gitignore template for Jupyter Notebooks# website: http://jupyter.org/.ipynb_checkpoints*/.ipynb_checkpoints/*# IPythonprofile_default/ipython_config.py# Jupyter lab virtual documents# https://jupyterlab-lsp.readthedocs.io/en/2.x/Configuring.html#virtual_documents_dir.virtual_documents/# Remove previous ipynb_checkpoints# git rm -r .ipynb_checkpoints/
Source des modèles : github/gitignore/community/Python/JupyterNotebooks.gitignore @356fd7b (2026-09-11) · CC0-1.0