본문으로 건너뛰기
Advertisement

Ch 1.2 파이썬 설치 가이드

파이썬 개발을 시작하기 위한 첫 번째 단계는 파이썬 인터프리터를 설치하는 것입니다. 운영체제별로 설치 방법이 다르며, 여러 버전을 관리하는 pyenv도 함께 소개합니다.

1. Windows 설치​

방법 1: 공식 설치 파일 (권장)​

  1. python.org/downloads 에서 최신 버전 다운로드
  2. 설치 시 "Add Python to PATH" 체크박스를 반드시 선택
  3. "Install Now" 또는 "Customize installation" 클릭
# 설치 확인
python --version
# Python 3.12.x

python3 --version
# Python 3.12.x (또는 동일 버전)

# pip 확인
pip --version

중요: Windows에서는 python 명령과 python3 명령이 모두 동일한 파이썬 3를 가리킵니다. PATH 설정이 되어 있어야 합니다.

방법 2: winget 패키지 매니저​

Windows 10/11에 기본 내장된 winget으로 설치할 수 있습니다.

# winget으로 Python 설치
winget install Python.Python.3.12

# 설치 후 터미널 재시작 필요
python --version

Windows PATH 수동 설정​

자동 설정이 안 된 경우:

  1. 시스템 환경 변수 → Path 편집
  2. 다음 두 경로 추가:
    • C:\Users\사용자명\AppData\Local\Programs\Python\Python312\
    • C:\Users\사용자명\AppData\Local\Programs\Python\Python312\Scripts\

2. macOS 설치​

방법 1: Homebrew (권장)​

# Homebrew 먼저 설치 (없는 경우)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Python 설치
brew install python@3.12

# 설치 확인
python3 --version
pip3 --version

macOS 시스템 파이썬 주의사항​

macOS에는 시스템 파이썬 (/usr/bin/python3)이 기본 내장되어 있습니다.

# 시스템 파이썬 경로 (건드리면 안 됨)
which python3
# /usr/bin/python3

# Homebrew로 설치한 파이썬 경로 (이것을 사용)
# /opt/homebrew/bin/python3 (Apple Silicon)
# /usr/local/bin/python3 (Intel Mac)

주의: macOS 시스템 파이썬은 운영체제 내부에서 사용합니다. 절대 sudo pip install로 시스템 파이썬에 패키지를 설치하지 마세요. 반드시 가상환경이나 Homebrew 파이썬을 사용하세요.

3. Linux 설치​

Ubuntu / Debian (apt)​

# 패키지 목록 업데이트
sudo apt update

# Python 설치
sudo apt install python3 python3-pip python3-venv

# deadsnakes PPA — 최신 버전 설치 (Ubuntu)
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev

# 설치 확인
python3.12 --version

CentOS / RHEL / Fedora (yum/dnf)​

# Fedora
sudo dnf install python3 python3-pip

# CentOS 8+ / RHEL 8+
sudo dnf install python38  # 또는 python39, python311

# 설치 확인
python3 --version

4. pyenv — 다중 버전 관리​

여러 파이썬 버전을 프로젝트별로 관리하려면 pyenv를 사용합니다.

pyenv 설치​

# macOS / Linux
curl https://pyenv.run | bash

# 셸 설정 파일에 추가 (~/.bashrc 또는 ~/.zshrc)
export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

# 설정 적용
source ~/.bashrc  # 또는 source ~/.zshrc

pyenv 주요 명령어​

# 설치 가능한 Python 버전 목록 조회
pyenv install --list

# 특정 버전 설치
pyenv install 3.12.3
pyenv install 3.11.9

# 설치된 버전 목록 확인
pyenv versions
# * system
#   3.11.9
#   3.12.3

# 전역 기본 버전 설정
pyenv global 3.12.3

# 특정 프로젝트 디렉토리에서만 사용할 버전 설정
cd my-project
pyenv local 3.11.9

# 현재 사용 중인 버전 확인
pyenv version
# 3.11.9 (set by /home/user/my-project/.python-version)

pyenv local 명령을 사용하면 해당 디렉토리에 .python-version 파일이 생성됩니다.

5. 설치 확인​

# Python 버전 확인
python --version
python3 --version

# pip 버전 확인
pip --version
pip3 --version

# 파이썬 위치 확인
which python3        # macOS/Linux
where python         # Windows

# 파이썬 REPL 실행 테스트
python3 -c "print('파이썬 설치 완료!')"

# 파이썬 정보 확인
python3 -c "import sys; print(sys.version); print(sys.executable)"
# Python REPL에서 직접 확인
import sys
print(f"Python 버전: {sys.version}")
print(f"실행 파일 경로: {sys.executable}")
print(f"플랫폼: {sys.platform}")
고수 팁: pyenv + pyenv-virtualenv 조합과 Windows py 런처

pyenv-virtualenv 플러그인을 함께 사용하면 버전 관리와 가상환경 관리를 한 번에 할 수 있습니다.

# pyenv-virtualenv 설치 (pyenv.run으로 이미 설치됨)

# 특정 Python 버전으로 가상환경 생성
pyenv virtualenv 3.12.3 my-project-env

# 가상환경 활성화
pyenv activate my-project-env

# 프로젝트 디렉토리에 자동 활성화 설정
cd my-project
pyenv local my-project-env
# 이제 해당 디렉토리에 들어오면 자동으로 가상환경 활성화!

# 가상환경 목록 확인
pyenv virtualenvs

Windows py 런처 활용:

Windows에서는 py 명령으로 버전을 지정하여 파이썬을 실행할 수 있습니다.

# 최신 Python 3 실행
py -3

# 특정 버전 지정 실행
py -3.12
py -3.11

# 스크립트 실행
py -3.12 script.py

# 설치된 버전 목록
py --list

파이썬 설치가 완료되었다면, 이제 코드를 편리하게 작성하기 위한 개발 환경을 구성할 차례입니다. 다음 챕터에서 VS Code, PyCharm, Jupyter Notebook 설정 방법을 알아보겠습니다.

Advertisement
Advertisement