Plantilla .gitignore de Jupyter Notebooks explicada
Explica por qué JupyterNotebooks.gitignore ignora .ipynb_checkpoints, el perfil de IPython y .virtual_documents, y cómo gestionar las salidas de los notebooks.
JupyterNotebooks.gitignore es una plantilla corta de la carpeta community del repositorio de plantillas y solo trata los archivos que Jupyter e IPython crean junto a los notebooks. No incluye entornos virtuales ni __pycache__, así que se usa junto con la plantilla de Python.
Los resultados de ejecución e imágenes que se guardan dentro del archivo de notebook (.ipynb) no son objeto de gitignore. No es una cuestión de archivos sino del contenido del archivo, así que se trata con otras herramientas.
Explicación regla por regla
| Patrón | Qué ignora y por qué |
|---|---|
.ipynb_checkpoints*/.ipynb_checkpoints/* | CheckpointsSon copias que Jupyter crea en cada carpeta con notebooks al guardar automáticamente. La primera línea captura las carpetas de checkpoints a cualquier profundidad y la segunda indica explícitamente el contenido de las carpetas un nivel por debajo. |
profile_default/ipython_config.py | Configuración de IPythonSon la carpeta de perfil y el archivo de configuración de IPython, que pueden contener información personal como la base de datos del historial de ejecución. |
.virtual_documents/ | LSP de JupyterLabEs la carpeta de documentos virtuales que crea la extensión jupyterlab-lsp para pasar los notebooks al servidor de lenguaje. |
Precauciones en la práctica
- Para no confirmar las salidas de los notebooks, instala
nbstripoutcomo filtro de git o acostúmbrate a borrar las salidas antes de hacer commit. - Esta plantilla no bloquea archivos de datos grandes (
data/,*.csv,*.parquet). Si hace falta, añádelos tú mismo o usa DVC o Git LFS. - Si guardas claves de API en
.envy las lees desde el notebook, también necesitas la regla.envde la plantilla de Python.
Plantilla original
# 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/
Origen de las plantillas: github/gitignore/community/Python/JupyterNotebooks.gitignore @356fd7b (2026-09-11) · CC0-1.0