PEP 8(Python Enhancement Proposal 8)은 「파이썬 코드를 어떻게 쓰는 것이 좋은가」를 정리한 공식 스타일 가이드입니다.
2001년 귀도 반 로섬이 직접 작성했으며, 오늘날 모든 파이썬 코드의 사실상 표준입니다.
핵심 규칙 몇 가지를 정리합니다.
들여쓰기는 4칸 공백(탭 X).
한 줄은 79자 이하(또는 100자).
함수·변수는 snake_case(my_function), 클래스는 PascalCase(MyClass), 상수는 UPPER_SNAKE(MAX_SIZE).
연산자 양쪽에 공백(x = 1 + 2, 단 함수 인자의 = 양쪽엔 공백 X — func(x=1)).
임포트는 파일 맨 위에 모아 두며, 「표준 라이브러리 → 외부 라이브러리 → 자기 모듈」 순서로 묶고 그 사이에 빈 줄.
import os 처럼 한 줄에 한 모듈씩 적는 게 권장됩니다.
비유하자면 PEP 8은 「영어 글의 문법책」과 같습니다.
따르지 않아도 코드는 동작하지만, 따르면 다른 파이썬 개발자가 즉시 알아보고 함께 작업하기가 쉬워집니다.
거의 모든 회사·오픈소스 프로젝트가 PEP 8을 표준으로 채택합니다.
수동으로 PEP 8을 외우지 않아도 됩니다.
「Black」(자동 포매터), 「Ruff」(빠른 린터), 「flake8」(전통 린터) 같은 도구들이 자동으로 검사·교정해 줍니다.
VS Code 같은 에디터에 이 도구들을 연동하면 저장할 때마다 자동으로 PEP 8 스타일로 정리됩니다.
한 줄 요약
PEP 8은 파이썬의 공식 스타일 가이드로, 들여쓰기·줄 길이·이름 규칙을 정해 코드 일관성을 만들어 줍니다.
Black·Ruff 같은 자동 도구가 검사·교정을 대신해 줍니다.
더 알아볼 것
- Black — 자동 포매터의 표준
- Ruff — 매우 빠른 새 린터
- PEP 8과 PEP 20(파이썬의 선)
