TechFeedTechFeed
Programming Languages

파이썬 설치 방법 완벽 가이드 2026 — 윈도우·맥·설치 확인까지

파이썬 설치를 윈도우와 맥에서 처음부터 끝까지 정리했습니다. 공식 인스톨러 다운로드, 윈도우 PATH 체크박스, python is not recognized 같은 흔한 설치 실패 해결, 맥 Homebrew vs python.org 선택, 3.12·3.13·3.14 버전 선택 기준, 설치 확인(python --version), pip와 venv 가상환경 기본까지. 2026년 6월 공식 릴리스 기준 파이썬 다운로드와 설치 확인 절차를 단계별로 안내합니다.

by

한 줄 핵심: 파이썬 설치는 윈도우면 python.org 공식 인스톨러에서 받아 'Add python.exe to PATH' 체크박스를 반드시 켜고, 맥이면 같은 공식 인스톨러(universal2)를 쓰는 게 가장 사고가 적습니다.


저는 12개 사이트를 1인으로 굴리면서 새 노트북을 셋업할 때마다 파이썬을 다시 깝니다. 그때마다 거의 항상 같은 곳에서 막혀요. 바로 PATH 체크박스를 빠뜨려서 터미널이 python is not recognized를 뱉는 순간입니다. 이 글은 그 사고를 미리 막는 데 초점을 맞춰, 다운로드부터 설치 확인, 그리고 첫 가상환경(venv)까지 한 번에 끝냅니다.


어떤 파이썬 버전을 설치해야 할까 (3.12 / 3.13 / 3.14)

먼저 버전부터 정리하고 시작하겠습니다. 파이썬은 마이너 버전(3.12, 3.13, 3.14)마다 거의 매년 새로 나오고, 그 안에서 버그픽스 패치(3.14.5 처럼 마지막 숫자가 오르는 것)가 수시로 나옵니다. 2026년 6월 기준 공식 릴리스 상황은 다음과 같습니다.


버전최신 패치(2026년 6월 기준)성격
Python 3.143.14.5 (2026-05-10)최신 안정 버전. 가장 최근 기능 포함
Python 3.133.13.13 (2026-04-07)널리 쓰이는 버전. 라이브러리 호환성 폭이 넓음
Python 3.123.12.13 (2026-03-03)안정성 검증이 충분히 된 보수적 선택

고민될 때 기준은 단순합니다.


  • 처음 배우거나 개인 프로젝트 → 최신 안정 버전(3.14.x)을 받으면 됩니다. 새 기능과 속도 개선을 그대로 누립니다.
  • 회사 코드·기존 프로젝트에 합류 → 그 프로젝트가 쓰는 버전에 맞춥니다. 보통 3.12나 3.13을 깔아야 합니다. 임의로 최신을 깔면 라이브러리 일부가 아직 새 버전 바이너리를 안 올려서 설치가 깨질 수 있습니다.
  • 특정 라이브러리(머신러닝·데이터)가 목적 → 그 라이브러리 공식 문서가 지원한다고 명시한 버전 중 가장 높은 것을 고릅니다.

파이썬 공식 다운로드 페이지에서 버전을 고르는 화면
ⓒ Python Software Foundation

윈도우에서 파이썬 다운로드와 설치

윈도우는 python.org 공식 인스톨러가 정답입니다. 마이크로소프트 스토어(Microsoft Store) 버전도 있지만, 권한·경로가 일반 설치와 미묘하게 달라서 나중에 venv나 외부 도구와 충돌하는 경우를 자주 봤습니다. 처음이라면 공식 인스톨러를 권합니다. 절차는 이렇습니다.


  1. python.org/downloads/windows 에 접속합니다.
  2. 원하는 버전의 Windows installer (64-bit)를 받습니다. 요즘 PC는 거의 다 64비트입니다.
  3. 받은 .exe를 실행하면 첫 화면이 나옵니다. 여기서 가장 중요한 한 가지가 있습니다.

⚠️ 설치창 맨 아래 'Add python.exe to PATH' 체크박스를 반드시 켜세요. 이걸 빠뜨리면 설치는 되지만 터미널에서 python 명령이 안 먹힙니다. 이 글 전체에서 가장 많은 사람이 막히는 지점이 바로 여기입니다.


체크박스를 켠 뒤 Install Now를 누르면 됩니다. 설치 중 'Disable path length limit'(경로 길이 제한 해제) 버튼이 나오면 눌러두는 편이 깊은 폴더 구조에서 안전합니다.


윈도우 파이썬 인스톨러의 Add python.exe to PATH 체크박스
ⓒ Python Software Foundation

케이스 분석: 'python is not recognized' 에러 해결

설치를 끝내고 터미널(명령 프롬프트 또는 PowerShell)을 열어 python --version을 쳤는데 아래 메시지가 나오는 경우가 가장 흔한 실패입니다. 케이스 → 원인 → 해결 순으로 풀어보겠습니다.


흔히 보는 에러 메시지
'python' is not recognized as an internal or external command, operable program or batch file.

케이스: 설치는 분명히 끝났는데 python이나 pip 명령이 전부 위 에러를 냅니다.


원인: 설치창에서 'Add python.exe to PATH' 체크를 빠뜨렸습니다. 그러면 윈도우가 python.exe가 어디 있는지 모릅니다. 또는 마이크로소프트 스토어의 'App execution aliases(앱 실행 별칭)'가 켜져 있어서, python을 치면 실제 파이썬 대신 스토어 창이 뜨기도 합니다.


해결 — 가장 쉬운 방법(추천): 인스톨러를 다시 실행해 Modify를 누르고, 'Add python.exe to PATH'를 켜서 다시 적용합니다. 이게 손이 제일 덜 갑니다.


해결 — 수동으로 PATH 추가:


  1. 시작 메뉴에서 '시스템 환경 변수 편집'을 검색해 엽니다.
  2. [고급] 탭 → [환경 변수] 버튼을 누릅니다.
  3. 위쪽 '사용자 변수'에서 Path를 더블클릭합니다.
  4. [새로 만들기]로 파이썬 설치 경로 두 개를 추가합니다. 보통 아래 형태입니다(버전 폴더명은 본인 설치 버전에 맞춥니다).

윈도우 PATH에 추가할 경로 예시 (사용자명·버전 폴더는 본인 환경에 맞게)
C:\Users\사용자명\AppData\Local\Programs\Python\Python314\ C:\Users\사용자명\AppData\Local\Programs\Python\Python314\Scripts\

저장한 뒤 터미널을 완전히 닫았다가 새로 엽니다(이미 열려 있던 창은 옛 PATH를 들고 있어서 반영이 안 됩니다). 그리고 아래로 실제 어떤 python.exe가 잡히는지 확인합니다.


PATH가 제대로 잡혔는지 확인
where python

결과에 ...\Python\Python314\python.exe 같은 실제 경로가 나오면 정상입니다. 만약 첫 줄이 ...\WindowsApps\python.exe로 나온다면 스토어 별칭이 가로채는 상태입니다. 설정 → 앱 → 고급 앱 설정 → 앱 실행 별칭에서 'python.exe'와 'python3.exe' 항목을 끄면 해결됩니다.


맥에서 파이썬 설치: python.org vs Homebrew

맥에는 시스템 파이썬이 깔려 있을 수 있지만, 그건 운영체제용이라 직접 개발에 쓰면 안 됩니다. 새로 설치하는 방법은 크게 두 갈래입니다.


방법 1 — python.org 공식 인스톨러(처음이라면 추천). python.org/downloads/macos 에서 macOS 64-bit universal2 installer(.pkg)를 받아 더블클릭하면 끝입니다. universal2 빌드라서 애플 실리콘(M칩)과 인텔 맥 모두에서 네이티브로 돕니다. 설치하면 시스템 파이썬과 별개로 공존하고, 기본 옵션 그대로면 python3가 새로 깐 쪽을 가리키게 됩니다.


방법 2 — Homebrew. 터미널에 익숙하다면 아래 한 줄로 깔 수 있습니다.


Homebrew로 파이썬 설치
brew install python

다만 Homebrew에는 알아둘 함정이 있습니다. brew upgrade를 돌리면 파이썬이 예고 없이 3.13에서 3.14로 올라가면서 이전 버전의 site-packages 폴더가 사라지는 경우가 있습니다. 그러면 pip로 깔아둔 패키지가 통째로 증발합니다. 또 Homebrew는 패치 단위(예: 3.12.4) 고정이 안 됩니다. 재현 가능한 빌드나 운영 서버와 인터프리터를 정확히 맞춰야 하는 상황에는 부적합합니다.


그래서 제 권장은 이렇습니다. 막 시작하는 단계면 python.org 공식 인스톨러가 사고가 가장 적습니다. 여러 버전을 자주 바꿔 써야 하는 단계가 오면 그때 pyenv나 uv 같은 버전 관리 도구를 얹는 걸 고려하면 됩니다. 처음부터 도구를 욕심내면 오히려 환경이 꼬입니다.


파이썬 설치 확인하는 법 (python --version)

설치가 끝났으면 반드시 설치 확인을 합니다. 터미널을 새로 열고 버전을 출력해봅니다. 운영체제별로 명령이 살짝 다릅니다.


파이썬 설치 확인 — 버전 출력
# 윈도우 python --version # 맥 (python.org / Homebrew 설치 모두 python3 권장) python3 --version

Python 3.14.5처럼 버전 번호가 찍히면 설치 성공입니다. 이어서 패키지 설치 도구인 pip도 함께 살아 있는지 확인합니다. pip는 보통 파이썬과 같이 깔립니다.


pip 버전 확인
# 윈도우 python -m pip --version # 맥 python3 -m pip --version

여기까지 버전 두 개가 정상 출력되면 개발 시작에 필요한 기본기는 다 갖춰진 겁니다. 참고로 pip를 직접 부르는 대신 python -m pip 형태를 권합니다. 어떤 파이썬에 연결된 pip인지 모호해지는 사고를 막아줍니다.


터미널에서 python --version으로 파이썬 설치를 확인한 화면
ⓒ Python Software Foundation

설치 다음 단계: venv 가상환경 만들기

파이썬을 깔자마자 곧장 pip install로 패키지를 전역에 쏟아붓는 분이 많은데, 이게 나중에 프로젝트끼리 라이브러리 버전이 충돌하는 가장 흔한 원인입니다. 처음부터 습관을 들이는 편이 낫습니다. 프로젝트마다 가상환경(venv)을 따로 만드는 것이 표준입니다. venv는 파이썬에 기본 내장이라 따로 설치할 게 없습니다.


프로젝트 폴더로 이동한 뒤 가상환경을 만듭니다.


가상환경 생성 (폴더명은 보통 venv 또는 .venv)
# 윈도우 python -m venv .venv # 맥 python3 -m venv .venv

만든 가상환경을 '활성화'하면 그때부터 그 안에 설치한 패키지만 따로 격리되어 관리됩니다. 활성화 명령은 운영체제별로 다릅니다.


가상환경 활성화
# 윈도우 (PowerShell) .venv\Scripts\activate # 맥 / 리눅스 source .venv/bin/activate

활성화되면 프롬프트 앞에 (.venv)가 붙습니다. 이 상태에서 패키지를 깔면 전역이 아니라 이 프로젝트 안에만 들어갑니다. 다 끝나면 deactivate로 빠져나옵니다.


가상환경 안에서 패키지 설치 / 빠져나오기
# 예시: requests 설치 python -m pip install requests # 가상환경 종료 deactivate

참고로 윈도우 PowerShell에서 활성화 시 이 시스템에서 스크립트를 실행할 수 없으므로 같은 실행 정책 에러가 뜨면, 관리자 권한 PowerShell에서 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned를 한 번 실행하면 풀립니다. 이건 venv 활성화 스크립트를 허용하는 설정입니다.


참고 자료

이 글의 버전·절차는 아래 공식 문서를 기준으로 작성했습니다. 가격이나 정책이 아닌 설치 절차라 자주 바뀌지는 않지만, 최신 버전 번호는 공식 다운로드 페이지에서 다시 확인하시길 권합니다(이 글은 2026년 6월 기준).



자주 묻는 질문

파이썬 설치할 때 윈도우에서 'Add python.exe to PATH'를 꼭 체크해야 하나요?

네, 처음 설치라면 반드시 켜는 걸 권합니다. 이 체크박스가 윈도우에게 python.exe의 위치를 알려주는 역할을 합니다. 빠뜨리면 설치 자체는 되지만 터미널에서 python 명령이 'is not recognized' 에러를 내며 안 먹힙니다. 이미 빠뜨렸다면 인스톨러를 다시 실행해 Modify로 체크를 켜서 재적용하면 가장 간단하게 해결됩니다.


파이썬 설치 확인은 어떻게 하나요?

터미널을 새로 열고 윈도우는 python --version, 맥은 python3 --version을 입력합니다. Python 3.14.5처럼 버전 번호가 출력되면 성공입니다. 이어서 python -m pip --version으로 패키지 설치 도구 pip도 정상인지 확인하면 완전합니다. 명령을 바꿨는데도 옛 결과가 나오면 터미널 창을 완전히 닫았다가 다시 여세요. 열려 있던 창은 변경 전 PATH를 그대로 들고 있습니다.


3.12, 3.13, 3.14 중 어떤 버전을 다운로드해야 하나요?

처음 배우거나 개인 프로젝트라면 최신 안정 버전인 3.14.x를 받으면 됩니다. 반면 기존 회사 코드나 특정 프로젝트에 합류하는 거라면 그 프로젝트가 쓰는 버전(보통 3.12나 3.13)에 맞춰야 합니다. 임의로 최신을 깔면 일부 라이브러리가 아직 새 버전용 바이너리를 안 올려서 설치가 깨질 수 있기 때문입니다. 라이브러리가 목적이라면 그 라이브러리 공식 문서가 지원한다고 명시한 버전 중 가장 높은 것을 고르세요.


맥은 python.org 인스톨러와 Homebrew 중 뭐가 나은가요?

막 시작하는 단계라면 python.org 공식 인스톨러(universal2 .pkg)가 사고가 가장 적습니다. 더블클릭 한 번으로 끝나고 애플 실리콘·인텔 맥 모두 네이티브로 돕니다. Homebrew는 편하지만 brew upgrade 때 파이썬이 예고 없이 올라가며 pip로 깐 패키지가 사라지는 경우가 있고, 패치 단위 버전 고정이 안 됩니다. 여러 버전을 자주 바꿔야 하는 단계가 오면 그때 pyenv나 uv 같은 전용 도구를 얹는 게 좋습니다.


venv 가상환경은 꼭 만들어야 하나요?

강력히 권합니다. 가상환경 없이 pip install로 패키지를 전역에 깔면, 프로젝트끼리 같은 라이브러리의 다른 버전을 요구할 때 충돌이 납니다. 프로젝트 폴더에서 python -m venv .venv로 환경을 만들고 활성화한 뒤 패키지를 설치하면, 그 패키지가 해당 프로젝트 안에만 격리됩니다. venv는 파이썬 기본 내장이라 추가 설치도 필요 없습니다.


pip를 그냥 'pip install'로 쓰면 안 되나요?

동작은 하지만 python -m pip install 형태를 권합니다. 시스템에 파이썬이 여러 개 깔려 있을 때 그냥 pip를 부르면 어느 파이썬에 연결된 pip인지 모호해져, 의도한 환경이 아닌 곳에 패키지가 설치되는 사고가 납니다. python -m pip는 지금 실행 중인 그 파이썬의 pip를 명시적으로 쓰기 때문에 이런 혼란을 막아줍니다. 가상환경을 활성화한 상태라면 그 안의 pip가 자동으로 잡힙니다.


파이썬 설치파이썬 설치 방법파이썬 설치 확인파이썬 다운로드python 설치PythonvenvpipHomebrewPATH

함께 보면 좋은 문제 해결

관련 포스트