[PYTHON] 모듈 관리의 3가지 핵심 원칙과 import *를 권장하지 않는 결정적 이유 및 해결 방법

import

 

파이썬(Python)은 '읽기 쉬운 코드가 좋은 코드다'라는 철학을 기반으로 설계된 언어입니다. 하지만 개발 과정에서 편의성을 위해 자주 사용하는 from module import * 구문은 이러한 파이썬의 철학을 정면으로 반박하며, 장기적으로 프로젝트의 유지보수성을 심각하게 해치는 요인이 됩니다. 본 글에서는 현업 시니어 개발자의 관점에서 왜 이 구문이 위험한지, 그리고 이를 대체할 수 있는 가장 효율적인 5가지 해결 방법은 무엇인지 심도 있게 분석합니다.

---

1. 네임스페이스 오염과 이름 충돌(Namespace Pollution & Name Clashes)

가장 큰 문제는 네임스페이스(Namespace)의 불투명성입니다. import *를 사용하면 해당 모듈 내의 모든 공개 객체(변수, 함수, 클래스)가 현재 스크립트의 로컬 네임스페이스로 쏟아져 들어옵니다. 이는 마치 정리되지 않은 서랍에 수많은 도구를 한꺼번에 집어넣는 것과 같습니다.

발생할 수 있는 심각한 문제점

• 이름 가리기(Shadowing): 현재 스크립트에서 정의한 함수나 변수가 임포트된 모듈의 객체와 이름이 같을 경우, 의도치 않게 덮어씌워지는 현상이 발생합니다.
• 출처 불분명: 코드를 읽는 동료(혹은 미래의 나)가 특정 함수가 어디서 정의되었는지 파악하기 위해 프로젝트 전체를 뒤져야 하는 수고를 유발합니다.

---

2. 100% 가독성 저하와 정적 분석 도구의 한계

전문적인 협업 환경에서는 PyLint, Flake8, MyPy와 같은 정적 분석 도구를 사용하여 코드의 결함을 찾아냅니다. 하지만 와일드카드 임포트를 사용하면 이러한 도구들이 어떤 이름이 유효한지 사전에 판단할 수 없게 되어, 자동 완성 기능이 무력화되고 잠재적인 런타임 에러를 잡아내지 못하게 됩니다.

---

3. 주요 모듈별 import 방식 비교 및 해결 차이

아래 표는 파이썬에서 권장되는 임포트 방식과 피해야 할 방식의 명확한 차이점을 정리한 것입니다.

구분	from module import * (비권장)	import module (권장)	from module import a, b (권장)
가독성	매우 낮음 (출처 알 수 없음)	매우 높음 (모듈명 명시)	높음 (사용 객체 명확)
네임스페이스	무차별 오염	격리 및 보호됨	선택적 노출
IDE 지원	자동 완성 제한적	완벽 지원	완벽 지원
실행 성능	모든 객체 로드 (미세하게 느림)	참조 방식 (효율적)	필요한 객체만 로드

---

4. [Sample Example] 실무 코드 적용 방법 및 해결 사례

안 좋은 예시 (Anti-Pattern)

from math import *
from my_custom_math_library import *

# 어떤 모듈의 sqrt가 호출될지 예측할 수 없으며, 코드 추적이 어렵습니다.
print(sqrt(16)) 

좋은 예시 (Best Practice)

명확성을 높이기 위해 별칭(Alias)을 사용하거나 특정 함수만 명시하여 임포트하는 2가지 해결 방법을 권장합니다.

# 방법 1: 모듈 전체를 가져오되 별칭 사용
import math as m
import my_custom_math_library as custom_m

print(m.sqrt(16))
print(custom_m.sqrt(16))

# 방법 2: 필요한 것만 명시적으로 임포트
from os import path, makedirs

---

5. 결론 및 요약

파이썬 프로그래밍에서 import *를 지양해야 하는 이유는 단순히 코딩 스타일의 문제가 아니라, 소프트웨어의 안정성과 지속 가능성의 문제입니다. 명시적인 코드는 묵시적인 코드보다 항상 낫습니다(Explicit is better than implicit). 지금 바로 여러분의 프로젝트에서 와일드카드 임포트를 제거하고, 명확한 네임스페이스 관리를 시작하시기 바랍니다.

[내용 출처 및 참고 문헌]

• Python Software Foundation. "PEP 8 – Style Guide for Python Code."
• Python Documentation. "Modules - The import statement."
• Clean Code in Python by Mariano Anaya.