Jupyter Notebooks .gitignore 템플릿 해설

JupyterNotebooks.gitignore는 템플릿 저장소의 community 폴더에 있는 짧은 템플릿으로, Jupyter와 IPython이 노트북 옆에 만드는 파일만 다룬다. 가상환경이나 __pycache__는 없으므로 Python 템플릿과 함께 쓴다.

노트북 파일(.ipynb) 안에 저장되는 실행 결과와 이미지는 gitignore의 대상이 아니다. 파일 단위가 아니라 파일 내용의 문제이므로 별도 도구로 다룬다.

규칙별 해설

패턴	무엇을, 왜 무시하나
`.ipynb_checkpoints/.ipynb_checkpoints/`	체크포인트Jupyter가 자동 저장할 때 노트북이 있는 폴더마다 만드는 복사본이다. 첫 줄은 모든 깊이의 체크포인트 폴더를, 둘째 줄은 한 단계 아래 폴더 안의 내용을 명시적으로 잡는다.
`profile_default/ipython_config.py`	IPython 설정IPython 프로필 폴더와 설정 파일로, 실행 기록 데이터베이스처럼 개인 정보가 들어갈 수 있다.
`.virtual_documents/`	JupyterLab LSPjupyterlab-lsp 확장이 언어 서버에 노트북을 전달하려고 만드는 가상 문서 폴더다.

노트북 출력을 커밋하지 않으려면 nbstripout을 git 필터로 설치하거나, 커밋 전에 출력 지우기를 습관화한다.
대용량 데이터 파일(data/, *.csv, *.parquet)은 이 템플릿이 막지 않는다. 필요하면 직접 추가하거나 DVC·Git LFS를 쓴다.
.env에 API 키를 두고 노트북에서 읽는다면 Python 템플릿의 .env 규칙이 함께 필요하다.