파이썬 스타일 가이드인 PEP 8 정리

파이썬 스타일 가이드인 PEP 8 정리&공부

독일에서 코딩 독학하는 독코독이 돌아왔습니다.
독학할때 파이썬은 chat gpt가 정말 도움이 많이 됩니다.
조만간 유료로 이용할거같아오 하하




파이썬 스타일 가이드인 PEP 8은 코드를 일관되고 가독성 있게 작성하기 위한 공식 문서야. 주요 내용을 간단히 정리해줄게!





✅ 1. 코드 레이아웃 (들여쓰기, 줄 길이 등)

🔹 들여쓰기 (Indentation)

공백 4칸을 사용해. (Tab은 쓰지 마!)


def my_function():
    print("Hello")  # 공백 4칸 사용

---

탭Tab은 왜 쓰지마?

좋은 질문이야!

파이썬에서는 보통 탭(Tab)보다 공백(Space)을 사용하는 걸 권장하는데, 이유를 하나씩 설명해줄게.

✅ 1. 일관성 문제 (혼용 금지)

파이썬은 탭(Tab)과 공백(Space)을 같이 쓰면 오류를 발생시킨다.

def example():
    if True:
        print("Hello")  # 공백 4칸
    print("World")  # 탭 1번 (IndentationError 발생!)

혼용 시 오류 발생😱
파이썬 3에서는 들여쓰기에 하나의 방식만 써야 해.

같은 깊이의 들여쓰기를 탭과 공백을 섞으면 IndentationError가 발생할 수 있어

✅ 2. 코드 가독성 (읽기 쉬움)

탭은 환경마다 크기(폭)가 다를 수 있어

대부분의 IDE(코드 편집기)에서는 공백 4칸을 기본 설정으로 사용해

🤩 예시

# 공백 4칸 (일관성 있음)
for i in range(5):
    print(i)

# 탭 (환경마다 다르게 보임)
for i in range(5):
print(i)

✅ 3. PEP 8 공식 권장 사항

문제점:

A 에디터에서는 탭이 4칸처럼 보이고

B 에디터에서는 탭이 8칸처럼 보일 수 있어.
환경마다 다르게 보이면 협업할 때 헷갈려!





공백 4칸을 사용하도록 공식 가이드에서 권장해.
대형 프로젝트(파이썬 표준 라이브러리 포함)도 공백 4칸을 따름.


✅ 4. 언제 탭을 써도 괜찮아?

개인 프로젝트에서 혼자 작업하는 경우 상관없어.
하지만 협업하거나 코드 리뷰를 받을 때는 공백 4칸이 더 좋아.

혼자 작업하면 탭을 써도 되지만,
공식 가이드(PEP 8)와 협업에서는 공백 4칸이 표준이야.

일관성 있는 코드가 유지보수하기 훨씬 편해!

---

🔹 줄 길이 (Line Length)

한 줄은 79자 이하로 작성해.

긴 줄은 **\**로 줄 바꾸기하거나, 괄호로 묶어줘.


# 줄이 길 경우
result = (value1 + value2 + value3
          + value4 + value5)

줄바꿀때 띄어쓰기 4번?

****추가질문
줄바꿀때 띄어쓰기 4번?

좋은 질문이야! 줄이 길어서 여러 줄로 나눌 때는 들여쓰기 규칙이 조금 달라져.




✅ 1. 줄이 길 때의 기본 규칙

괄호((), [], {}) 안에 있으면 자동으로 줄이 이어짐.

추가 들여쓰기(Indentation)는 필수는 아니지만, 코드를 정렬해서 보기 쉽게 만드는 걸 권장해.

✅ 2. 어떻게 들여쓰기 해야 할까?

1. 괄호 안에서는 줄을 바꿀 때 들여쓰기는 보통 4칸 정도 해.


2. 연산자(+, -, *, /)는 다음 줄 앞에 두는 게 더 가독성이 좋아.



📌 올바른 예제



# 연산자를 다음 줄 앞에 두고, 4칸 들여쓰기
result = (value1 + value2 + value3
          + value4 + value5)

또는 이렇게도 가능해:

# 연산자를 앞에 두는 방식
result = (
    value1 + value2 + value3
    + value4 + value5
)

❌ 비추천 예제 (헷갈리는 스타일)

result = (value1 + value2 + value3
    + value4 + value5)  # 들여쓰기 불일치 (혼란 유발)

✅ 3. 다른 경우의 줄 바꿈

수식이 아닌 경우에도 괄호로 묶으면 줄 바꿈 가능해.


my_list = [
    "apple", "banana", "cherry",
    "date", "fig"
]

백슬래시(\)로 줄을 나눌 수도 있지만, 괄호를 쓰는 게 더 깔끔하고 안전해.


result = value1 + value2 + \
         value3 + value4


괄호 안에서는 4칸 들여쓰기가 권장되지만 필수는 아님.

연산자는 줄 바꿈 시 다음 줄 앞에 두는 게 더 가독성이 좋아.

PEP 8은 괄호 사용을 추천하고, 백슬래시는 가급적 피하라고 권장해.

---

🔹 빈 줄 (Blank Lines)

클래스와 함수 사이: 빈 줄 2개

함수 내부에서 논리적인 구분: 빈 줄 1개


class MyClass:
    
    def method_one(self):
        pass
    
    def method_two(self):
        pass




✅ 2. 공백 사용 (Spaces)

🔹 연산자와 할당문

=, +, -, ==, != 등의 양쪽에 공백을 넣어.

괄호 안쪽에는 공백을 넣지 마.


x = 10 + 5  # 올바름
y=10+5      # 비추천

print(x)    # 올바름
print( x )  # 비추천 (괄호 안에 공백 X)




🔹 쉼표, 콜론, 세미콜론

쉼표(,) 뒤에는 공백을 넣어.

콜론(:)은 for, while, if 등에서 앞에 공백 금지.

# 올바름
if x == 5:
    print(x)

# 비추천
if x == 5 :
    print(x)




✅ 3. 네이밍 규칙 (Naming Conventions)

🔹 변수와 함수 이름

소문자 + 밑줄(_) 형식을 사용해.

상수는 **대문자 + 밑줄(_)**로.


my_variable = 42      # 변수
calculate_sum()       # 함수
MAX_VALUE = 100       # 상수




🔹 클래스 이름

**카멜케이스(CamelCase)**를 사용해.


class MyClass:
    pass



✅ 4. 기타 중요한 규칙

🔹 import 순서

1. 표준 라이브러리

2. 서드파티(Third-party) 패키지

3. 로컬 모듈



# 올바른 순서
import os
import sys

import numpy as np

from mymodule import my_function


🔹 불필요한 코드 생략

빈 코드를 쓸 때는 **pass**를 사용해.


def my_function():
    pass  # 아무것도 하지 않음

PEP 8을 따르면 코드가 깔끔하고 유지보수하기 쉬워진다!