Python용 .gitignore

저장소에 바로 복사할 수 있는 Python 제외 규칙 95개.

Python 프로그래밍 언어

Python용 전체 .gitignore

# LFGitignore로 생성 - https://lfgitignore.com
# 생성일: 2026-10-13 16:10:43 UTC
# 기술: Python

### Python ###
# Python 바이트코드 캐시 디렉터리
__pycache__/
*.py[codz]
# Python/Jython 클래스 파일
*$py.class
# IPython 기본 프로필
profile_default/
# 공유 객체
*.so
# IPython 구성
ipython_config.py
# Python 버전 표시 파일
.Python
# 빌드 출력 디렉터리
build/
# Python 개발용 egg
develop-eggs/
# 배포 디렉터리
dist/
# 다운로드한 파일
downloads/
# Python egg 패키지
eggs/
# Python egg 디렉터리
.eggs/
# 라이브러리 디렉터리
lib/
# 64비트 라이브러리 디렉터리
lib64/
# Buildout 구성 요소
parts/
# Python 소스 배포본
sdist/
var/
# Python wheel 패키지
wheels/
# 공유 Python wheel
share/python-wheels/
# Python 패키지 메타데이터
*.egg-info/
# Buildout 설치 구성
.installed.cfg
# Python egg 패키지
*.egg
# Python 매니페스트 파일
MANIFEST
# 매니페스트 파일
*.manifest
# PyInstaller spec 파일
*.spec
# pip 설치 로그
pip-log.txt
# pip 표시 파일
pip-delete-this-directory.txt
# 커버리지 HTML 보고서
htmlcov/
# tox 테스트 환경
.tox/
# nox 테스트 환경
.nox/
# 커버리지 데이터 파일
.coverage
# 커버리지 데이터 파일
.coverage.*
# 캐시 디렉터리
.cache
# Nose 테스트 결과
nosetests.xml
# 커버리지 XML 보고서
coverage.xml
# 커버리지 주석이 달린 소스
*.cover
*.py.cover
# LCOV 커버리지 데이터
*.lcov
# Hypothesis 테스트 데이터
.hypothesis/
# pytest 캐시 디렉터리
.pytest_cache/
# 커버리지 보고서
cover/
# 컴파일된 메시지 카탈로그
*.mo
# 메시지 카탈로그 템플릿
*.pot
# 로그 파일
*.log
# 로컬 Django 설정
local_settings.py
# SQLite 데이터베이스
db.sqlite3
# SQLite 저널
db.sqlite3-journal
# Flask 인스턴스 폴더
instance/
# Flask-Assets 캐시
.webassets-cache
# Scrapy 캐시
.scrapy
# Sphinx 빌드 결과
docs/_build/
# PyBuilder 디렉터리
.pybuilder/
# Maven 빌드 디렉터리
target/
# Jupyter notebook 체크포인트
.ipynb_checkpoints
.pdm-python
.pdm-build/
.pixi/*
# PEP 582 패키지
__pypackages__/
!.pixi/config.toml
# Celery beat PID 파일
celerybeat.pid
# Sage 컴파일된 파일
*.sage.py
celerybeat-schedule*
# 환경 변수
.env
*.rdb
.envrc
*.aof
# Python 가상 환경
.venv
# 프로세스 ID 파일
*.pid
# 가상 환경 디렉터리
env/
mnesia/
# 가상 환경 디렉터리
venv/
rabbitmq/
# 환경 백업
env.bak/
rabbitmq-data/
activemq-data/
# 가상 환경 백업
venv.bak/
# Spyder 프로젝트
.spyderproject
# Spyder 프로젝트 설정
.spyproject
# Python rope 리팩터링
.ropeproject
/site
# mypy 타입 검사기 캐시
.mypy_cache/
# mypy 데몬 구성
.dmypy.json
# mypy 데몬 구성
dmypy.json
# Pyre 타입 검사기
.pyre/
# pytype 정적 분석기
.pytype/
# Cython 디버그 심볼
cython_debug/
.abstra/
.ruff_cache/
.pypirc
marimo/_static/
marimo/_lsp/
__marimo__/
.streamlit/secrets.toml
tempCodeRunnerFile.py

이 Python 규칙이 실제로 제외하는 항목

아래에서 각 패턴과 .gitignore에 포함하는 이유를 확인하세요.

바이트 컴파일된 파일 / 최적화된 파일 / DLL 파일

패턴 제외 대상
__pycache__/ Python 바이트코드 캐시 디렉터리
*.py[codz] 바이트 컴파일된 파일 / 최적화된 파일 / DLL 파일
*$py.class Python/Jython 클래스 파일

IPython

패턴 제외 대상
profile_default/ IPython 기본 프로필
ipython_config.py IPython 구성
.pdm-python pdm: Pipfile.lock과 마찬가지로 pdm.lock을 버전 관리에 포함하는 것이 일반적으로 권장됩니다. pdm은 pdm.toml의 프로젝트 공통 구성은 포함하고 .pdm-python은 제외하도록 권장합니다. https://pdm-project.org/en/latest/usage/project/#working-with-version-control pdm.lock pdm.toml
.pdm-build/ IPython
.pixi/* pixi: Pipfile.lock과 마찬가지로 pixi.lock을 버전 관리에 포함하는 것이 일반적으로 권장됩니다. pixi.lock Pixi는 venv 모듈이 .venv에 가상 환경을 만드는 것처럼 .pixi 디렉터리에 가상 환경을 만듭니다. 이 디렉터리는 버전 관리에서 제외하는 것이 좋습니다.
!.pixi/config.toml IPython

C 확장

패턴 제외 대상
*.so 공유 객체

배포 / 패키징

패턴 제외 대상
.Python Python 버전 표시 파일
build/ 빌드 출력 디렉터리
develop-eggs/ Python 개발용 egg
dist/ 배포 디렉터리
downloads/ 다운로드한 파일
eggs/ Python egg 패키지
.eggs/ Python egg 디렉터리
lib/ 라이브러리 디렉터리
lib64/ 64비트 라이브러리 디렉터리
parts/ Buildout 구성 요소
sdist/ Python 소스 배포본
var/ 배포 / 패키징
wheels/ Python wheel 패키지
share/python-wheels/ 공유 Python wheel
*.egg-info/ Python 패키지 메타데이터
.installed.cfg Buildout 설치 구성
*.egg Python egg 패키지
MANIFEST Python 매니페스트 파일
*.manifest 매니페스트 파일
*.spec PyInstaller spec 파일

설치 프로그램 로그

패턴 제외 대상
pip-log.txt pip 설치 로그
pip-delete-this-directory.txt pip 표시 파일

단위 테스트 / 커버리지 보고서

패턴 제외 대상
htmlcov/ 커버리지 HTML 보고서
.tox/ tox 테스트 환경
.nox/ nox 테스트 환경
.coverage 커버리지 데이터 파일
.coverage.* 커버리지 데이터 파일
.cache 캐시 디렉터리
nosetests.xml Nose 테스트 결과
coverage.xml 커버리지 XML 보고서
*.cover 커버리지 주석이 달린 소스
*.py.cover 단위 테스트 / 커버리지 보고서
.hypothesis/ Hypothesis 테스트 데이터
*.lcov LCOV 커버리지 데이터
.pytest_cache/ pytest 캐시 디렉터리
cover/ 커버리지 보고서

번역

패턴 제외 대상
*.mo 컴파일된 메시지 카탈로그
*.pot 메시지 카탈로그 템플릿

Django 관련 항목:

패턴 제외 대상
*.log 로그 파일
local_settings.py 로컬 Django 설정
db.sqlite3 SQLite 데이터베이스
db.sqlite3-journal SQLite 저널

Flask 관련 항목:

패턴 제외 대상
instance/ Flask 인스턴스 폴더
.webassets-cache Flask-Assets 캐시

Scrapy 관련 항목:

패턴 제외 대상
.scrapy Scrapy 캐시

Sphinx 문서

패턴 제외 대상
docs/_build/ Sphinx 빌드 결과

PyBuilder

패턴 제외 대상
.pybuilder/ PyBuilder 디렉터리
target/ Maven 빌드 디렉터리

Jupyter Notebook

패턴 제외 대상
.ipynb_checkpoints Jupyter notebook 체크포인트

PEP 582; github.com/David-OConnor/pyflow 및 github.com/pdm-project/pdm 등에서 사용

패턴 제외 대상
__pypackages__/ PEP 582 패키지

Celery 관련 항목

패턴 제외 대상
celerybeat.pid Celery beat PID 파일
celerybeat-schedule* Celery 관련 항목

SageMath 파싱된 파일

패턴 제외 대상
*.sage.py Sage 컴파일된 파일

환경

패턴 제외 대상
.env 환경 변수
.envrc 환경
.venv Python 가상 환경
env/ 가상 환경 디렉터리
venv/ 가상 환경 디렉터리
env.bak/ 환경 백업
venv.bak/ 가상 환경 백업

Redis

패턴 제외 대상
*.rdb Redis
*.aof Redis
*.pid 프로세스 ID 파일

RabbitMQ

패턴 제외 대상
mnesia/ RabbitMQ
rabbitmq/ RabbitMQ
rabbitmq-data/ RabbitMQ

ActiveMQ

패턴 제외 대상
activemq-data/ ActiveMQ

Spyder 프로젝트 설정

패턴 제외 대상
.spyderproject Spyder 프로젝트
.spyproject Spyder 프로젝트 설정

Rope 프로젝트 설정

패턴 제외 대상
.ropeproject Python rope 리팩터링
/site mkdocs 문서
.mypy_cache/ mypy 타입 검사기 캐시
.dmypy.json mypy 데몬 구성
dmypy.json mypy 데몬 구성

Pyre 타입 검사기

패턴 제외 대상
.pyre/ Pyre 타입 검사기
.pytype/ pytype 정적 분석기

Cython 디버그 심볼

패턴 제외 대상
cython_debug/ Cython 디버그 심볼

자세히 알아보기: https://abstra.io/docs

패턴 제외 대상
.abstra/ 자세히 알아보기: https://abstra.io/docs

Ruff 관련 항목:

패턴 제외 대상
.ruff_cache/ Ruff 관련 항목:

PyPI 구성 파일

패턴 제외 대상
.pypirc PyPI 구성 파일

Marimo

패턴 제외 대상
marimo/_static/ Marimo
marimo/_lsp/ Marimo
__marimo__/ Marimo

Streamlit

패턴 제외 대상
.streamlit/secrets.toml Streamlit

부분 코드 실행용 임시 파일

패턴 제외 대상
tempCodeRunnerFile.py 부분 코드 실행용 임시 파일

이 Python용 .gitignore 사용 방법

  1. 위의 Python 규칙을 복사하거나 파일을 바로 다운로드하세요.
  2. Git 저장소 루트에 .gitignore라는 파일을 만들고 규칙을 붙여 넣으세요.
  3. 이미 추적 중인 파일이 있다면 git rm -r --cached . 명령을 실행한 다음 다시 커밋하세요. Git은 추적하지 않는 파일에만 제외 규칙을 적용합니다.
  4. 팀원 모두가 같은 규칙을 사용하도록 .gitignore를 커밋하세요.

다른 언어용 .gitignore 템플릿

모든 언어 템플릿 보기