파이썬 가상환경(python venv) 설정 2편: PATH로 “파이썬” 위치와 버전 확인하기

파이썬 가상환경(python venv) 설정 이미지

“분명 Python 가상환경(python venv)을 설치했는데, 왜 python3 --version 명령어로 확인한 파이썬은 다른 버전이지?” 이런 경우를 정말 많이 봤습니다.

대부분의 경우, 파이썬이 이상한 게 아니라 터미널이 프로그램을 찾는 방식, 즉 PATH 때문이에요.

터미널은 python3를 실행할 때 컴퓨터 전체를 랜덤으로 뒤지지 않습니다.
PATH라는 ‘검색 순서 리스트’를 앞에서부터 보면서, 제일 먼저 발견한 python3를 실행in the file.

지난번 Sublime Text를 이용한 subl . 명령어 사용법에 이어 오늘 포스트의 핵심은 딱 하나예요.

“내 터미널이 지금 어느 파이썬을 끌고 왔는지 증거를 확인하자.”

오늘 목표(딱 3개)

  1. PATH 출력하기
  2. 파이썬 실행 파일 위치 찾기
  3. 버전 확인해서 기록하기

1) Mac으로 오늘 목표 달성하기: echo $PATH → Β which python3 → Β python3 --version

Mac은 흐름이 아주 단순합니다. 제목에서 보는 바와 같이 그 순서대로만 하면 돼요.

Step 1. PATH를 먼저 출력

echo $PATH

#출력내역
/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin/python3

처음엔 길고 복잡해 보여도 괜찮아요. 지금은 “이게 검색 순서구나”만 느끼면 됩니다.

Step 2. 터미널이 실제로 쓰는 python3 위치 확인

which python3

#출력내역
/opt/homebrew/bin/python3

여기 출력된 경로가 바로 “내 터미널이 고른 python3”입니다.

Step 3. 버전 확인(결론)

python3 --version

#출력내역
Python 3.14.2

위와 같이 파이썬 버전까지 확인할 수 있습니다.

Step 4. 결과를 메모해두기

  • which python3 결과 경로
  • python3 --version 결과 버전

이 두 줄만 기록해두면, 다음 포스트에서 다룰 주제에서 문제 생겨도 원인 추적이 엄청 쉬워집니다.

2) Windows: where python + py --version으로 깔끔하게 확인

Windows는 파이썬이 여러 개 잡혀 있는 경우가 더 흔합니다. 그래서 먼저 “여러 개인지”부터 확인해요.

Step 1. python 위치 찾기

where python
  • 한 줄이면 비교적 단순
  • 여러 줄이면 “python.exe가 여러 개”일 수 있습니다(놀라지 마세요. 흔한 일입니다.)

Step 2. 버전 확인(Windows에서 편한 방법)

py --version

Windows에서는 python보다 py가 버전 확인/관리 측면에서 더 깔끔하게 느껴질 때가 많아요.

윈도우에서는 왜 py라고만 입력해도 되나요?

맥(Mac)과 달리 Windows에서 py 명령어만 쳐도 Python이 실행되는 이유는 Python Launcher for Windows라는 Microsoft 공식 런처 때문입니다.​

Python 설치 시 자동 포함되는 py.exe Windows Python 설치 프로그램(공식 python.org 설치자)에서 “Add Python to PATH” 체크 시 자동으로 설치되는 py.exe가 핵심입니다.
C:\Windows\System32\py.exe ← 이미 모든 Windows PATH에 포함

This py.exe는 다음과 같이 Python 버전 매니저 런처 역할을 합니다.
py → 기본 Python 3 버전 실행
py --version → 설치된 Python 버전 목록 출력
py -3.12 → 특정 버전 지정 실행

Step 3. 실제 실행 버전 확인(테스트)

py -c "import sys; print(sys.version)"

이건 “지금 py로 실행되는 파이썬이 무엇인지”를 한 번에 보여줍니다.

3) 자주 나오는 상황별 해석(초보자용)

python venv setup image

✅ 정상 케이스

  • Mac: which python3 경로가 하나고, 버전도 의도한 값
  • Windows: py --version이 의도한 값(또는 설치한 버전과 일치)

🤔 헷갈리기 쉬운 케이스

  • 설치한 것 같은데 버전이 낮다
    → “설치 실패”보다는 PATH 우선순위일 가능성이 큽니다.
    (이건 나중에 “버전/경로 관리 습관”으로 아주 쉽게 정리해드릴게요.)

오늘의 체크리스트

Mac

  • echo $PATH 출력했다
  • which python3 경로 확인했다
  • python3 --version 버전 확인했다

Windows

  • where python 출력 확인했다(몇 줄인지 체크)
  • py --version 확인했다
  • py -c "import sys; print(sys.version)" 실행했다

본문 이미지(텍스트 없음)

Finalize

여기까지 잘 따라오셨으면 이제 “내가 파이썬을 쓸 준비”가 된 겁니다. 왜냐하면 설치보다 더 중요한 걸 해냈거든요.

  • 내 파이썬이 어디 있는지 알고
  • 어떤 버전이 실행되는지 알고
  • 문제가 생겼을 때 “추측”이 아니라 “증거”로 확인할 수 있게 됐습니다.

Glossary of terms for beginners

PATH (경로 검색 순서 리스트)

쉽게 말하면 터미널이 프로그램을 찾는 “주소록”입니다. 컴퓨터에는 같은 이름의 프로그램이 여러 군데 있을 수 있어요. 터미널은 PATH 목록을 앞에서부터 차례대로 훑으면서 “아, 여기 있네!” 하고 제일 먼저 찾은 걸 실행합니다.
Example: /usr/local/bin이 맨 앞에 있으면 그 안의 python3를 먼저 씁니다. 목록 뒤에 있는 건 무시돼요!​

which 명령어 (실제 실행 위치 알려주는 탐정)

“지금 터미널이 python3를 어디서 가져오고 있어?”라고 물어보는 명령어. which python3 → Β /opt/homebrew/bin/python3 이런 식으로 정확한 파일 위치를 알려줍니다. 가상환경 만들었는데 여전히 시스템 python이 뜬다면, 이 명령으로 “아, PATH 때문에 시스템 거 쓰고 있구나”를 바로 알 수 있어요.

py.exe (Windows 전용 Python 런처 마법 지팡이)

Windows에서 py만 쳐도 Python이 실행되게 해주는 특별 관리자. C:\Windows\System32\py.exe에 사는 녀석으로, 설치할 때 자동 포함됩니다. py --version, py -3.12처럼 버전 선택도 알아서 해줍니다. 맥의 python3보다 똑똑해요!

가상환경 (venv) (각 프로젝트마다 독립된 Python 방)

“이 프로젝트는 이 Python만 쓰고, 다른 프로젝트랑 섞이지 마!”라고 만드는 격리된 공간. python -m venv myproject로 만들면, 그 폴더 안에서만 독자적인 패키지와 Python 버전을 씁니다. 전역 Python과 완전 분리돼서 버전 충돌 걱정 없음.

echo $PATH (주소록 전체 내용 출력)

터미널의 PATH 목록을 종이에 써서 보여주는 명령어. Mac: echo $PATH, Windows: echo %PATH% 처음엔 길어서 무섭지만, 검색 순서 파악에 최고예요. /usr/local/bin이 앞에 있나? 가상환경 경로가 추가됐나? 한눈에 확인!

where 명령어 (Windows 버전 which)

Windows에서 which 역할을 하는 명령어. where python → 설치된 모든 python.exe 위치를 여러 줄로 보여줍니다. 한 줄이면 단순, 여러 줄이면 “아, Python이 여러 버전이네”를 바로 알게 돼요.

Similar Posts