파이썬 문장, 들여쓰기, 주석: 명확한 가이드

파이썬 문장, 들여쓰기, 주석

이 가이드는 파이썬 문장, 일관된 들여쓰기의 중요성, 주석과 독스트링 효과적 사용법을 설명합니다.

인터프리터가 실행하는 파이썬 명령을 문장(statement)이라 합니다. 대표적으로 a = 1 같은 대입문, if, for, while 같은 제어 흐름 문장이 있습니다. 이들은 모든 파이썬 프로그램의 빌딩 블록입니다.

기본적으로 줄바꿈이 문장을 종료합니다. 긴 문장을 여러 줄로 나누려면 백슬래시(\) 줄 연속 문자를 사용하세요:

a = 1 + 2 + 3 + \
4 + 5 + 6 + \
7 + 8 + 9

더 파이썬다운 방법은 괄호, 대괄호, 중괄호 안에서 암시적 연속을 허용하는 것입니다:

a = (1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9)

리스트 리터럴도 여러 줄로 쓸 수 있습니다:

colors = ['red', 'blue', 'green']

세미콜론으로 한 줄에 여러 단순 문장을 나열할 수도 있습니다:

a = 1; b = 2; c = 3

중괄호로 블록을 구분하는 언어와 달리, 파이썬은 순수하게 들여쓰기로 코드 블록을 정의합니다. 블록은 콜론 뒤에 시작하며, 블록 시작 기준으로 들여쓰지 않은 첫 줄에서 끝납니다.

언어는 일관된 들여쓰기 레벨이면 허용하지만, 커뮤니티 표준은 공백 4칸입니다. 탭은 혼동을 피하기 위해 피해야 합니다.

for i in range(1, 11):
    print(i)
    if i == 5:
        break

올바른 들여쓰기는 문법을 강제할 뿐 아니라 코드를 즉시 읽고 유지보수하기 쉽게 만듭니다. 예:

if True:
    print('Hello')
    a = 5

가독성 낮은 한 줄 형태와 대비:

if True: print('Hello'); a = 5

잘못된 들여쓰기는 IndentationError를 일으켜 실행을 중단시킵니다.

주석은 의도와 로직을 문서화하는 데 필수적이며, 특히 몇 달 뒤 코드를 다시 볼 때 중요합니다. 파이썬에서 주석은 해시(#)로 시작해 줄 끝까지 이어집니다. 인터프리터는 이 줄을 완전히 무시합니다.

# 이것은 주석입니다
# 인사 출력
print('Hello')

여러 줄에 걸쳐 주석을 달려면 각 줄 앞에 #을 붙이세요:

# 이것은 긴 주석입니다
# 여러 줄에 걸쳐
# 계속됩니다

또는 삼중 따옴표 문자열을 블록 주석으로 쓸 수 있습니다. 대입되거나 독스트링으로 사용되지 않으면 인터프리터가 버리므로 런타임 비용이 없습니다:

"""이것은 여러 줄에 걸친
블록 주석입니다."""

독스트링은 함수, 클래스, 모듈 정의 바로 뒤에 오는 문자열 리터럴입니다. 요소의 목적을 문서화하며 __doc__ 속성에 저장됩니다. 관례적으로 삼중 따옴표를 사용합니다:

def double(num):
    """입력값의 두 배를 반환합니다."""
    return 2 * num

프로그래밍적으로 접근 가능:

print(double.__doc__)

출력:

입력값의 두 배를 반환합니다.

자세한 가이드라인은 공식 파이썬 문서의 주석과 독스트링을 참조하세요.

python