`__init__.py` 에 코드

HY_1023·2026년 3월 13일

헷갈리는 부분 정리

목록 보기
14/40

__init__.py 에 코드


한 마디로

대부분 비워두는 파일이에요!


기본 용도

# __init__.py 의 핵심 역할
# "이 폴더는 Python 패키지입니다" 라고 선언하는 파일

my_project/
  ├── app/
  │   ├── __init__.py  ← 이게 있어야 app 폴더가 패키지로 인식
  │   ├── main.py
  │   └── models.py

보통 이렇게 사용

✅ 비워두기 (가장 일반적)

# __init__.py
# 그냥 비어있음 - 이것만으로도 역할 충분!

✅ 자주 쓰는 것만 모아두기

# __init__.py
from .models import User, Item      # 자주 쓰는 모델
from .database import get_db        # DB 연결
from .utils import format_date      # 유틸 함수

이렇게 하면 import가 짧아져요!

# __init__.py 없을 때 (길어요 ❌)
from app.models.user import User

# __init__.py 있을 때 (짧아요 ✅)
from app import User

FastAPI 프로젝트에서 실제 사용

fastapi_project/
  ├── app/
  │   ├── __init__.py      ← 보통 비워둠
  │   ├── main.py
  │   ├── models/
  │   │   ├── __init__.py  ← 보통 비워둠
  │   │   └── user.py
  │   └── routers/
  │       ├── __init__.py  ← 보통 비워둠
  │       └── users.py

결론

소규모 프로젝트  → 그냥 비워두세요 ✅
대규모 프로젝트  → import 정리용으로 활용 ✅

💡 파일이 비어있어도 절대 삭제하면 안돼요!
없으면 Python이 폴더를 패키지로 인식 못해서
import 할 때 에러가 발생해요! ❌

profile
개발언어를 배우는 과정 기록

0개의 댓글