시작하기

이 장에서는 Python 3을 설치하고, 대화형 셸(REPL)에서 코드를 시험해 보고, 스크립트 파일을 실행하는 방법을 다룹니다. 이어서 프로젝트마다 패키지를 따로 관리하는 가상 환경(venv)과 패키지 설치 도구 pip, 편집기 설정까지 살펴봅니다. 이 장을 마치면 새 Python 프로젝트를 깔끔하게 시작할 수 있습니다.

Python 3 설치

Python 2는 이미 지원이 끝났으므로 새 프로젝트는 항상 Python 3으로 시작합니다. 운영 체제마다 설치 방법이 조금 다릅니다.

• Windows: python.org의 설치 프로그램을 쓰거나 Microsoft Store에서 설치합니다. 설치 프로그램을 쓴다면 PATH에 추가하는 옵션을 켜 두는 것이 편합니다.
• macOS: python.org 설치 프로그램이나 Homebrew(brew install python)를 씁니다.
• Linux: 대부분 배포판에 이미 들어 있습니다. 없다면 배포판 패키지 관리자로 설치합니다.

설치가 끝나면 터미널에서 버전을 확인합니다. Windows에서는 여러 버전을 골라 실행해 주는 py 런처를 쓸 수도 있습니다.

python3 --version
# Windows
py --version

REPL로 바로 시험하기

python3(Windows에서는 py 또는 python)를 인자 없이 실행하면 대화형 셸이 열립니다. 프롬프트 >>> 뒤에 식을 입력하면 곧바로 결과를 보여 주므로, 문법이나 라이브러리 동작을 빠르게 확인할 때 좋습니다. help(len)처럼 내장 도움말을 볼 수 있고, exit()나 Ctrl+D(Windows는 Ctrl+Z 후 Enter)로 빠져나옵니다.

2 ** 10            # 1024
"python".upper()   # 'PYTHON'
len([1, 2, 3])     # 3
import math
math.sqrt(16)      # 4.0

스크립트 실행

실제 프로그램은 .py 파일로 작성합니다. 아래 파일을 hello.py로 저장합니다.

import sys


def main() -> None:
    name = sys.argv[1] if len(sys.argv) > 1 else "world"
    print(f"Hello, {name}!")


if __name__ == "__main__":
    main()

if __name__ == "__main__": 블록은 파일을 직접 실행할 때만 동작하고, 다른 파일에서 import할 때는 실행되지 않습니다. 실행은 다음과 같이 합니다.

python3 hello.py
python3 hello.py Alice
# 모듈 이름으로 실행할 수도 있습니다
python3 -m http.server 8000

가상 환경(venv)

프로젝트마다 필요한 패키지와 버전이 다르기 때문에, 시스템 Python에 모든 것을 설치하면 금세 충돌이 납니다. 표준 라이브러리의 venv 모듈은 프로젝트 폴더 안에 독립된 Python 환경을 만들어 이 문제를 해결합니다.

# 프로젝트 폴더에서 .venv 라는 가상 환경을 만듭니다
python3 -m venv .venv

# 활성화 (macOS / Linux)
source .venv/bin/activate

# 활성화 (Windows PowerShell)
.venv\Scripts\Activate.ps1

# 비활성화
deactivate

활성화하면 python과 pip가 가상 환경 안의 것을 가리키고, 프롬프트 앞에 (.venv)가 붙습니다. .venv 폴더는 다시 만들 수 있으므로 Git에는 올리지 않고 .gitignore에 넣습니다. 지금 어떤 Python이 실행되는지 헷갈릴 때는 python -c "import sys; print(sys.executable)"로 인터프리터 경로를 확인할 수 있습니다. 경로가 .venv 안을 가리키면 가상 환경이 제대로 활성화된 것입니다.

pip로 패키지 설치

pip는 PyPI에서 패키지를 내려받아 설치합니다. 가상 환경을 활성화한 뒤 쓰는 것이 원칙이며, 어떤 Python에 설치되는지 분명히 하려고 python -m pip 형태를 권장합니다.

python -m pip install requests
python -m pip install --upgrade requests
python -m pip list
python -m pip uninstall requests

편집기 설정

어떤 편집기든 쓸 수 있지만, 다음 기능을 갖추면 훨씬 편합니다.

1. Python 확장 설치: VS Code라면 Microsoft의 Python 확장, JetBrains 계열이라면 PyCharm을 씁니다.
2. 인터프리터 선택: 편집기가 프로젝트의 .venv 안 Python을 쓰도록 지정합니다. 그래야 자동 완성과 오류 표시가 설치한 패키지를 인식합니다.
3. 포매터와 린터: Black이나 Ruff로 코드 모양을 자동으로 맞추고 흔한 실수를 잡습니다.
4. 타입 검사: mypy나 Pyright로 타입 힌트를 검사합니다(3장에서 다룹니다).

정리

• 새 프로젝트는 Python 3으로 시작하고, python3 --version으로 설치를 확인합니다.
• REPL은 짧은 실험에, .py 스크립트는 실제 프로그램에 씁니다.
• 프로젝트마다 python3 -m venv .venv로 가상 환경을 만들고 활성화한 뒤 작업합니다.
• 패키지는 python -m pip install로 설치하고, 편집기가 가상 환경의 인터프리터를 쓰도록 맞춥니다.