파이썬: 언더스코어(_)로 시작하는 함수명의 의미

---

파이썬: 언더스코어(_)로 시작하는 함수명의 의미

파이썬에서 함수명이 단일 언더스코어(_)로 시작하는 것을 본 적이 있을 것이다. 이러한 명명 규칙은 파이썬 개발자들이 코드를 작성할 때 널리 따르는 관례이다. 이는 파이썬 인터프리터가 강제하는 기술적인 제약은 아니며, 특정 함수가 어떻게 사용되기를 의도하는지를 다른 개발자에게 알려주는 중요한 역할을 한다.

---

1. 언더스코어(_)의 역할: 약한 비공개(Weak "Private") 지시자

파이썬에서 언더스코어로 시작하는 함수나 변수는 약한 비공개(weak "private") 지시자로 통용된다. 이는 C++나 자바 같은 언어의 private 키워드처럼 외부 접근을 문법적으로 차단하는 것이 아니다. 대신, 해당 함수가 모듈이나 클래스 외부에서 직접 호출되거나 사용되도록 의도되지 않았다는 것을 시사한다. 이 규칙은 협업 환경에서 코드를 더 명확하게 이해하고 유지보수하는 데 도움을 준다.

2. 헬퍼 함수(Helper Function)와 언더스코어

언더스코어로 시작하는 함수는 종종 헬퍼 함수(Helper Function)라고 불린다. 헬퍼 함수는 특정 작업을 수행하는 데 필요한 보조적인 역할을 하는 함수이다. 주 함수(main function)의 복잡한 로직을 작은 단위로 분리하여 코드의 가독성과 재사용성을 높이는 데 사용된다.

예를 들어, 데이터를 처리하는 process_data()라는 공용 함수가 있다고 가정해 보자. 이 함수가 데이터를 정제하고, 계산하며, 최종 결과물을 포맷팅하는 여러 단계를 포함한다면, 각 단계를 _clean_data(), _calculate_metrics(), _format_output()와 같은 헬퍼 함수로 분리할 수 있다. 이렇게 하면 process_data() 함수는 전체적인 작업 흐름을 한눈에 보여주고, 세부 구현은 헬퍼 함수에 위임하여 코드가 훨씬 깔끔하고 이해하기 쉬워진다.

# data_processor.py
def _clean_data(data):
    """데이터를 정제하는 내부 헬퍼 함수"""
    return [d.strip() for d in data]

def process_data(data_list):
    """
    외부에서 호출되는 주요 함수.
    내부 헬퍼 함수들을 사용하여 작업을 완료한다.
    """
    cleaned = _clean_data(data_list)
    return cleaned

# 다른 파일에서 사용
import data_processor
my_data = [" apple ", "  banana", "cherry  "]
result = data_processor.process_data(my_data)
print(result)

이 코드는 외부에서 process_data() 함수만 호출하도록 의도되었음을 명확히 보여준다. _clean_data() 함수는 process_data()의 내부 구현을 돕는 보조 역할에 그치는 것이다.

3. from module import *와 언더스코어의 상호작용

언더스코어는 from 모듈명 import * 구문과도 관련이 있다. 이 구문을 사용할 때, 언더스코어로 시작하는 이름은 가져오기 목록에서 자동으로 제외된다. 이 기능은 의도치 않게 내부 함수가 전역 네임스페이스를 오염시키는 것을 방지하여 코드의 안정성을 높인다.

결론적으로, 파이썬에서 함수명에 언더스코어(_)를 사용하는 것은 코드를 더 구조적이고 이해하기 쉽게 만드는 중요한 명명 규칙이다. 이는 단순한 문법적 기능이 아니라, 개발자 간의 소통과 협업을 위한 파이썬 커뮤니티의 약속이다.

---