[Python] 55강 모듈과 import 개념 (코드를 파일로 나누기)

---

---

이 강의는 파이썬 강의 55강입니다.
이전 강의에서는 텍스트 게임을 하나 끝까지 완성했습니다.
이번 강의에서는 코드가 커지기 시작할 때 반드시 필요한 개념,
모듈(module)과 import를 배웁니다.

핵심은 이것입니다.
파일 하나 = 프로그램 하나라는 생각에서 벗어난다.

---

모듈이 왜 필요한가

지금까지는
모든 코드를 하나의 파일에 작성했습니다.

하지만 코드가 늘어나면
이런 문제가 생깁니다.

• 파일이 너무 길어진다
• 기능 찾기가 힘들다
• 재사용이 어렵다

그래서 코드를
기능별 파일로 나누는 방법이 필요합니다.
이때 사용하는 것이 모듈입니다.

---

1️⃣ 모듈이란 무엇인가

모듈은
파이썬 코드가 들어 있는 파일(.py)입니다.

예를 들면:

• game.py
• utils.py
• player.py

이 파일 하나하나가
모두 모듈입니다.

---

2️⃣ 모듈을 불러오는 기본 방법 (import)

다른 파일의 코드를 사용하려면
import를 사용합니다.

import random

지금까지 사용한
random도 이미 모듈이었습니다.

---

3️⃣ 직접 만든 모듈 불러오기

같은 폴더에
utils.py 파일을 만들고
아래 코드를 작성합니다.

# utils.py
def hello():
    print("안녕하세요!")

이제 다른 파일에서 불러옵니다.

import utils

utils.hello()

모듈이름.함수이름 형태입니다.

---

4️⃣ 필요한 것만 불러오기 (from import)

모듈 이름을 매번 쓰기 싫다면
이 방식을 사용합니다.

from utils import hello

hello()

코드가 짧아지지만
어디서 온 함수인지 헷갈릴 수 있습니다.

---

5️⃣ import 방식 선택 기준

아주 간단한 기준입니다.

• 규모가 커질수록 → import 모듈명
• 작은 연습용 → from 모듈 import 함수

초반에는
모듈명 붙이는 방식을 추천합니다.

---

6️⃣ 모듈로 코드 나누기 예시

텍스트 게임을
파일로 나눈다고 가정합니다.

• main.py → 게임 루프
• player.py → 플레이어 상태
• battle.py → 전투 로직

이렇게 나누면
코드 관리가 훨씬 쉬워집니다.

---

7️⃣ 파이썬이 모듈을 찾는 위치

파이썬은 기본적으로:

1. 현재 파일이 있는 폴더
2. 파이썬 기본 라이브러리 폴더

에서 모듈을 찾습니다.

그래서
같은 폴더에 있으면 바로 import 됩니다.

---

8️⃣ 실습 예제

아래를 직접 해보세요.

1. calc.py 파일 생성
2. 아래 코드 작성

# calc.py
def add(a, b):
    return a + b

   3. 다른 파일에서 불러오기

import calc

result = calc.add(3, 5)
print(result)

---

이번 강의 핵심 정리

• 모듈은 파이썬 파일이다
• import로 다른 파일의 코드를 사용한다
• 기능별로 파일을 나누면 관리가 쉬워진다
• 모듈화는 큰 프로그램의 시작이다

---