[파이썬] PEP8 완벽 정리 - 실무에서 바로 쓰는 Python 코드 작성법

🔍 파이썬 스타일 가이드(PEP 8) 완벽 정리 — 실무에서 바로 쓰는 Python 코드 작성법

파이썬(Python)의 가독성과 유지보수성을 높이기 위한 공식 문서가 바로 PEP 8 스타일 가이드입니다.
특히 초보자일수록 PEP 8을 잘 알고 있으면 코드 품질이 크게 향상되고, 협업에서도 좋은 평가를 받을 수 있습니다.

아래에서는 실무에서 즉시 적용 가능한 핵심 규칙만 선별하여 정리했습니다.

---

📌 목차

1. PEP 8이 중요한 이유
2. 변수·함수·상수의 이름 규칙
3. 의미 있는 이름을 만들어야 하는 이유
4. 들여쓰기·공백·괄호 등 화이트 스페이스 규칙
5. 연산자·지정 연산자 사용 규칙
6. 주석(Comment) 작성 방법
7. PEP 8을 지키면 생기는 실무적 장점

---

1. PEP 8이 중요한 이유

PEP 8은 Python 코드를 어떻게 작성해야 가장 읽기 좋은가에 대해 정의한 공식 스타일 가이드입니다.
개인 공부뿐 아니라 회사 프로젝트에서도 기본 기준으로 사용됩니다.

---

2. 변수·함수·상수의 이름 규칙

✔ 변수·함수: 소문자 + 밑줄

# bad
someVariableName = 1
SomeVariableName = 1

def someFunctionName():
    print("Hello")
# good
some_variable_name = 1

def some_function_name():
    print("Hello")

✔ 상수: 대문자 + 밑줄

# bad
someConstant = 3.14
SomeConstant = 3.14
some_constant = 3.14
# good
SOME_CONSTANT = 3.14

---

3. 의미 있는 이름 사용

✔ 변수

# bad (의미 없는 이름)
a = 2
b = 3.14
print(b * a * a)
# good (의미 있는 이름)
radius = 2
PI = 3.14
print(PI * radius * radius)

✔ 함수

# bad (의미 없는 이름)
def do_something():
    print("Hello, world!")
# good (의미 있는 이름)
def say_hello():
    print("Hello, world!")

가독성과 유지보수성을 위해 의도를 담은 이름이 중요합니다.

---

4. 화이트 스페이스 규칙(들여쓰기·띄어쓰기)

✔ 스페이스 4칸 들여쓰기

# bad (스페이스 2개)
def do_something():
  print("Hello, world!")
# bad (스페이스 8개)
i = 0
while i < 10:
        print(i)
# good (스페이스 4개)
def say_hello():
    print("Hello, world!")

✔ 함수 정의 간 공백 2줄

# bad
def a():
    print('a')
def b():
    print('b')

def c():
    print('c')
# good
def a():
    print('a')


def b():
    print('b')


def c():
    print('c')

✔ 괄호 안 공백 금지

# bad
spam( ham[ 1 ], { eggs: 2 } )
# good
spam(ham[1], {eggs: 2})

✔ 함수명과 괄호 사이 공백 금지

# bad
def spam (x):
    print (x + 2)


spam (1)
# good
def spam(x):
    print(x + 2)


spam(1)

✔ 쉼표 앞 공백 금지

# bad
print(x , y)
# good
print(x, y)

---

5. 연산자 규칙

✔ 지정 연산자(=, += 등) 앞뒤에 공백 1개

# bad
x=1
x    = 1
# good
x = 1

✔ 일반 연산자도 앞뒤 공백

# bad
i=i+1
submitted +=1
# good
i = i + 1
submitted += 1

✔ 우선순위 표현을 위해 공백 생략 가능

# bad
x = x * 2 - 1
hypot2 = x * x + y * y
c = (a + b) * (a - b)
# good
x = x*2 - 1
hypot2 = x*x + y*y
c = (a+b) * (a-b)

---

6. 주석(Comment) 작성 규칙

✔ 같은 줄에 주석 달 때 띄어쓰기 2칸

# bad
x = x + 1# 코멘트
# good
x = x + 1  # 코멘트

---

7. PEP 8을 지키면 실무에서 좋아지는 점

• 협업 시 코드 이해 속도 상승
• 에러 감소 및 유지보수 편리
• 리팩터링 비용 절감
• 파이썬 커뮤니티와 코드 스타일 통일

결국 PEP 8을 지키면 ‘읽기 좋은 코드 → 좋은 개발자’로 이어집니다.