파이썬 가상환경(Mac & Windows) 설정 완전 가이드

Python 개발을 시작할 때 가장 먼저 해야 할 일 중 하나가 프로젝트별 가상환경(virtual environment) 설정입니다.
가상환경을 사용하면 프로젝트마다 패키지 버전을 독립적으로 관리할 수 있어서 충돌 없이 안정적으로 개발할 수 있습니다.

본 글에서는 Mac과 Windows에서 각각 파이썬 가상환경을 생성하고 실행하는 방법을 단계별로 정리합니다.

개요

• Mac(Homebrew 기반)에서 Python 3.10 설치 및 가상환경 생성
• Windows(기본 Python 설치 기반)에서 가상환경 생성
• venv 기반 가상환경 생성, 활성화, 비활성화 방법
• 초보자도 그대로 따라 할 수 있게 명령어 중심 구성

1. Mac에서 가상환경 설정하기 (Homebrew + venv)

Mac은 Homebrew를 통해 Python을 손쉽게 관리할 수 있습니다.

1) Python 3.* 설치 여부 확인

python3.* --version

설치되어 있지 않다면 버전 정보가 출력되지 않습니다.

2) Python 3.10 설치 (Homebrew 이용)

brew install python@3.10

설치 완료 후 실행 파일이 존재하는지 확인합니다.

ls /opt/homebrew/opt/python@3.10/bin

3) 설치된 Python 경로 확인

brew --prefix python@3.10

경로는 보통 다음과 같습니다:

/opt/homebrew/opt/python@3.10

4) 가상환경 생성

방법 1) 절대경로 기반 생성 (Homebrew Python을 직접 지정)

/opt/homebrew/bin/python3.10 -m venv 가상환경명

방법 2) 현재 위치에서 간단 생성

python3.10 -m venv 가상환경명

예:

python3.10 -m venv myenv

5) 가상환경 활성화(activate)

source datavenv/bin/activate

활성화되면 터미널 프롬프트 앞에 가상환경명이 표시됩니다:

(datavenv) user@Mac %

6) 가상환경 비활성화(deactivate)

deactivate

2. Windows에서 가상환경 설정하기 (cmd 또는 PowerShell)

Windows는 기본 Python 설치만 되어 있으면 바로 venv를 사용할 수 있습니다.

1) Python 버전 확인

python --version

또는

py --version

2) 가상환경 생성

Windows에서는 python 또는 py 명령을 사용합니다.

python -m venv 가상환경명

예:

python -m venv myenv

가상환경 폴더 구조 예:

myenv/
 ├─ Scripts/
 │    ├─ activate
 │    ├─ python.exe
 │    └─ pip.exe
 └─ Lib/

3) 가상환경 활성화

cmd 명령어

myenv\Scripts\activate

PowerShell 명령어

myenv\Scripts\Activate.ps1

PowerShell 정책 오류가 발생하면 아래 명령으로 해결:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

4) 가상환경 비활성화

Mac과 동일합니다.

deactivate

Mac과 Windows 모두 파이썬의 기본 가상환경 도구인 venv만으로 프로젝트 별 독립된 개발 환경을 관리할 수 있습니다.
Mac은 Homebrew 기반 Python 관리가 핵심이고, Windows는 Python 설치 후 Scripts/activate 기반으로 쉽게 활성화할 수 있습니다.
가상환경 설정은 패키지 충돌을 방지하고 개발 효율을 높이는 필수 과정이므로, 새로운 프로젝트 시작 시 반드시 생성해 두는 것을 권장합니다.