설치부터 버전 관리, 가상 환경까지

파이썬(Python) 프로그래밍을 시작하기 위한 첫걸음, 바로 올바른 설치입니다. 단순히 파이썬을 설치하는 것을 넘어, 다양한 프로젝트를 효율적으로 관리하기 위한 최적의 설치 방법과 버전 관리, 필수 가상 환경 설정 방법까지 완벽하게 정리해 드립니다.

초보자라면 이 가이드를 따라 pyenv와 venv 조합으로 파이썬 환경을 구축하는 것을 강력 추천합니다.

1. 파이썬 설치 방법 비교: 무엇을 선택할까?

파이썬을 설치하는 방법은 크게 세 가지가 있습니다. 프로젝트 성격에 맞는 방법을 선택하세요.

방법 특징 추천 대상
pyenv 이용한 설치 파이썬 버전을 자유롭게 전환 가능. 패키지 관리가 깔끔함. 모든 개발자 (강력 추천)
공식 페이지 설치 가장 직관적이지만, 여러 버전 관리가 번거로울 수 있음. 초단기 단순 작업자
Anaconda 배포판 데이터 과학용 패키지가 미리 포함되어 편리함. 설치 용량이 큼. 데이터 사이언티스트, 머신러닝 엔지니어

2. 파이썬 버전 관리자: pyenv 설치 및 사용법 (강력 추천)

pyenv는 파이썬 버전 관리 도구입니다. 시스템 전역 파이썬 버전과 별개로 프로젝트별로 원하는 파이썬 버전을 손쉽게 설치하고 전환할 수 있습니다.

2-1. pyenv 설치하기

Windows 환경 (pyenv-win)

PowerShell을 관리자 권한으로 실행한 후 아래 명령어를 한 줄씩 입력하여 설치합니다.

 
# pyenv-win 설치 스크립트 실행
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "install-pyenv-win.ps1"; .\install-pyenv-win.ps1

💡 권한 에러 발생 시: 스크립트 실행 권한을 변경해야 할 수 있습니다. 다음 명령어를 실행해 주세요.

# 현재 사용자에 대한 영구 보안 설정 (추천)
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

macOS 환경 (with Homebrew)

Homebrew가 설치되어 있다면 터미널에서 간단하게 설치할 수 있습니다.

 
brew install pyenv

# 셸 설정 파일(~/.zshrc 등)에 pyenv 환경 변수 추가 (자동 설정)
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init --path)"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

Ubuntu (Linux) 환경

터미널에서 의존성 패키지를 설치한 후 pyenv 설치 스크립트를 실행합니다.

# 의존성 패키지 설치
sudo apt-get update
sudo apt-get install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

# pyenv 자동 설치 스크립트 실행
curl https://pyenv.run | bash

⚠️ 중요: 설치 완료 후 터미널에 출력되는 안내 메시지에 따라 ~/.bashrc 또는 ~/.zshrc 파일 맨 아래에 환경 변수 설정을 추가해야 할 수도 있습니다. (자동으로 안 된 경우)

2-2. pyenv로 파이썬 설치 및 설정하기

설치가 완료되면 터미널에서 pyenv 명령어를 사용하여 파이썬을 자유롭게 제어할 수 있습니다.

 
# 1. 설치 가능한 모든 파이썬 버전 목록 보기
pyenv install --list

# 2. 특정 버전 파이썬 설치 (예: 최신 안정 버전)
pyenv install 3.12.3

# 3. 설치된 버전 목록 확인
pyenv versions

# 4. 전역(기본) 파이썬 버전 설정
pyenv global 3.12.3

# 5. 현재 폴더(프로젝트) 전용 파이썬 버전 설정 (해당 폴더에 .python-version 파일 생성)
pyenv local 3.12.3

# 6. 버전 확인 (현재 설정된 파이썬 버전 출력)
python --version

2-3. 가상 환경 설정: 프로젝트별 독립 공간 만들기

가상 환경(Virtual Environment)은 각 프로젝트마다 독립적인 파이썬 패키지 공간을 제공합니다. 프로젝트 A는 파이썬 3.10, 프로젝트 B는 3.12를 써야 할 때 의존성 충돌을 방지하는 필수 기술입니다.

파이썬 3.3 이상부터는 기본 내장된 venv 모듈 사용을 추천합니다.

2-3-1. venv 모듈을 사용한 가상 환경 생성 및 관리

1. 가상 환경 생성

프로젝트 폴더로 이동한 후 아래 명령어를 실행합니다. (예: 폴더 이름이 my_project)

 
# 현재 폴더에 '.venv'라는 이름의 가상 환경 생성
python -m venv .venv

2. 가상 환경 활성화

작업 전에는 반드시 가상 환경을 활성화해야 합니다. 활성화되면 터미널 프롬프트 앞에 (.venv) 표시가 나타납니다.

  • Windows:

     
    .venv\Scripts\activate

  • macOS / Linux:

     
    source .venv/bin/activate

3. 가상 환경 비활성화

작업이 끝나면 아래 명령어로 가상 환경에서 빠져나옵니다.

 
deactivate

4. 가상 환경 삭제

가상 환경을 삭제하려면 해당 폴더(.venv) 자체를 지우면 됩니다.

  • Windows: 탐색기에서 삭제 또는

     
    rmdir /s /q .venv

  • macOS / Linux: 터미널에서

     
    rm -rf .venv

2-4. 핵심 요약: 추천 파이썬 시작 루틴

다양한 프로젝트를 문제없이 진행하기 위해 강력하게 추천하는 루틴입니다.

  1. 글로벌 파이썬 설치: pyenv global 명령어로 시스템 기본 파이썬 버전을 설치합니다.

  2. 프로젝트 준비: 프로젝트 폴더를 만들고 이동합니다.

  3. 프로젝트별 버전 지정: pyenv local [버전] 명령어로 해당 프로젝트에 사용할 파이썬 버전을 지정합니다.

  4. 가상 환경 생성: python -m venv .venv 명령어로 가상 환경을 생성합니다.

  5. 가상 환경 활성화: 활성화합니다.

  6. 패키지 설치: pip install 명령어로 필요한 라이브러리를 설치합니다. (모든 패키지는 가상 환경 내에만 설치됨)

  7. 문제 발생 시: .venv 폴더를 삭제하고 4번부터 다시 시작하면 깨끗한 환경에서 다시 시작할 수 있습니다.

3. 공식 페이지를 이용한 일반 파이썬 설치

가장 직관적이고 표준적인 방법입니다. 파이썬 공식 웹사이트에서 설치 파일을 다운로드하여 직접 설치하는 방식입니다.

3-1. 설치 방법

  • 다운로드: 공식 웹사이트(python.org)의 다운로드(Downloads) 메뉴로 이동하여 최신 안정 버전의 설치 파일을 다운로드합니다.

  • 설치 진행 (Windows / macOS):

    1. 다운로드한 설치 파일을 실행합니다.

    2. ⚠️ 가장 중요: 첫 화면(또는 사용자 지정 설치 화면)에 나오는 “Add Python to PATH” (PATH에 Python 추가) 옵션에 반드시 체크해야 합니다. 이 옵션을 켜야 명령 프롬프트(CMD)나 터미널에서 python 명령어를 정상적으로 인식합니다.

    3. “Install Now”를 눌러 기본 설정으로 설치를 완료합니다.

  • 리눅스(Ubuntu) 환경의 경우: 터미널에서 패키지 매니저를 통해 간단하게 설치할 수 있습니다.

    sudo apt update
sudo apt install python3

1-2. 설치 확인

터미널이나 명령 프롬프트를 열고 아래 명령어를 입력했을 때 정상적인 버전 숫자가 출력되면 성공입니다.

python --version
# 또는
python3 --version

4. Anaconda(아나콘다) 배포판 설치

아나콘다는 데이터 과학, 머신러닝, 인공지능(AI) 개발에 필요한 수백 개의 필수 라이브러리(NumPy, Pandas, Scikit-Learn 등)와 패키지 관리 도구(Conda)가 한 번에 포함되어 있는 대규모 파이썬 배포판입니다.

4-1. 아나콘다의 특징 및 장점

  • 원스톱 패키지 제공: 데이터 분석이나 머신러닝 환경을 구축할 때 필요한 무거운 라이브러리들을 일일이 pip로 설치할 필요 없이 기본 탑재되어 있어 매우 편리합니다.

  • 독립된 가상 환경(Conda Environment) 관리: 자체적인 가상 환경 시스템을 제공하여 패키지 간 충돌을 방지합니다.

  • 단점: 포함된 패키지가 많아 설치 용량이 매우 크고(수 GB 이상), 가벼운 웹 개발이나 일반 스크립트 용도로는 다소 과할 수 있습니다.

4-2. 설치 방법

  1. 다운로드: Anaconda 공식 홈페이지에서 운영체제(Windows, macOS, Linux)에 맞는 설치 파일을 다운로드합니다.

  2. 설치 진행: 다운로드한 인스톨러를 실행하고 화면 지시에 따라 설치를 진행합니다. (설치 중 경로 설정 관련 권장 옵션을 그대로 두고 진행하시면 됩니다.)

  3. 사용 확인: 설치 후 Anaconda Prompt(Windows) 또는 일반 터미널(macOS/Linux)을 열어 가상 환경을 생성하고 관리할 수 있습니다.

답글 남기기