PEP 8은 파이썬 코드의 일관성을 높이는 스타일 지침입니다. 새 파일을 작성할 때 기본값으로 유용하지만, 이미 운영 중인 프로젝트를 규칙에 맞춘다는 이유로 대량 수정하면 기능 변경 검토가 어려워질 수 있습니다.
먼저 맞출 규칙
들여쓰기 4칸, 함수·변수의 snake_case, 클래스의 CapWords, import 구분부터 시작하세요. 공백과 줄바꿈은 자동 포맷 도구로 일관되게 유지할 수 있습니다. PEP 8 원문은 표준 라이브러리의 관례와 함께 프로젝트 내부 일관성이 더 중요할 수 있음을 설명합니다.
리팩터링 범위를 나누기
기능 수정 PR과 전체 포맷 변경 PR을 분리하세요. 그렇지 않으면 리뷰어가 실제 동작 변경을 찾기 어렵습니다. 기존 파일의 작은 부분을 고칠 때는 주변 코드와 충돌하지 않는 범위에서 정리하고, 팀 전체 규칙 변경은 합의한 뒤 자동 검사를 추가합니다.
검증 방법
포맷과 린트 결과만 보지 말고 테스트와 실행 결과도 확인하세요. 이름을 바꾸면 외부에서 import하는 코드가 깨질 수 있습니다. 코드 예제를 포트폴리오에 넣을 때는 스타일 준수보다 왜 이런 함수 구조를 선택했는지 설명하는 편이 유익합니다. 협업 기록을 보여 주는 방법은 Git 학습 가이드를 참고하세요.