1. Windows에서 어떤 설치 방식을 고를까요?
일반 학습·개발
Install Manager
공식 권장 방식입니다. Store 또는 python.org에서 Manager를 설치한 뒤 필요한 Python 런타임을 받습니다.
인터넷 없는 PC
런타임 사전 준비
Manager 설치 파일 외에 offline index와 런타임도 필요합니다. 추가 pip 패키지는 따로 준비합니다.
다른 앱에 포함
embeddable ZIP
앱 개발자를 위한 최소 환경입니다. pip·IDLE가 없으므로 일반 학습용 설치를 대신하지 않습니다.
Manager는 런타임을 설치·관리하는 도구입니다. Manager 설치 파일과 Python 런타임 파일을 구분하세요.
2. Python 설치와 실행 환경
파이썬(Python)은 읽기 쉬운 문법과 폭넓은 패키지 생태계를 갖춘 범용 프로그래밍 언어입니다. 자동화 스크립트, 웹 서비스, 데이터 분석과 인공지능까지 용도가 넓고 Python Software Foundation License에 따라 개인·기업 프로젝트에서 비용 없이 사용할 수 있습니다. 2026년 11월 확인한 최신 안정판은 Python 3.15.2입니다. 강의나 프로젝트가 요구하는 버전과 핵심 패키지의 지원 범위를 먼저 확인하세요. 유지 중인 3.14 계열 프로젝트를 최신판이라는 이유만으로 바로 바꿀 필요는 없습니다.
Windows의 공식 권장 설치 방식은 Python Install Manager입니다. python.org 또는 Microsoft Store에서 Manager를 설치한 뒤 `python` 명령으로 최신 안정 런타임을 받거나 `py install 3.14`처럼 버전을 지정할 수 있습니다. Store판과 python.org 배포판의 Manager 기능은 같으며, 예전 전체 설치 프로그램과 Python Launcher는 3.14부터 구형 방식으로 분류됩니다. 따라서 오래된 안내처럼 첫 화면에서 [Add python.exe to PATH]를 반드시 찾는 방식으로 설명하면 현재 설치 화면과 맞지 않을 수 있습니다.
macOS는 python.org의 universal2 `.pkg` 설치 파일이 Apple Silicon과 지원되는 Intel Mac에서 동작하며, 설치 후 응용 프로그램의 `Install Certificates.command`를 실행해야 SSL 인증서 설정이 완료됩니다. macOS가 관리하는 `/usr/bin/python3`는 삭제하거나 바꾸면 안 됩니다. Linux는 배포판 패키지 관리자를 우선 사용하고, 소스 빌드가 필요하다면 시스템 `python3`를 덮어쓰지 않도록 주의해야 합니다. 프로젝트별 `.venv`를 만들면 패키지 설치 위치를 분리할 수 있습니다. 활성화는 명령 입력을 편하게 하는 선택 사항이며, 가상환경의 Python 실행 파일을 직접 지정해 `-m pip`를 호출하는 방법도 있습니다.
3. 설치 후 패키지 도구 선택
Python을 설치한 다음에는 코드를 실행할 환경과 패키지를 관리할 방식을 고르면 됩니다. 모든 도구를 함께 설치할 필요는 없습니다. 기존 프로젝트가 지정한 도구와 버전·선언·잠금 파일이 있으면 그 구성을 우선 따르세요.
| 도구 | 기본 역할 |
|---|---|
| Python | 프로그램 코드를 실행하는 언어·인터프리터 |
| venv | 선택한 Python으로 프로젝트별 패키지 환경 생성 |
| pip | 그 Python 환경 안에 패키지를 설치 |
| uv | Python 버전·프로젝트 환경·의존성·잠금 관리 |
| Poetry | 프로젝트 의존성·가상환경·잠금·패키징 관리 |
일반 pip 경로라면 현재 사용할 Python의 -m pip로 설치 위치를 맞춥니다. 예를 들어 가상환경의 Python 실행 파일을 직접 지정하면 활성화 여부와 관계없이 대상 환경을 명확히 할 수 있습니다. 생성·경로 확인 절차는 파이썬 가상환경 만들기에 있습니다.
python -m pip --version
위 명령은 현재 python이 가리키는 환경을 보여 줍니다. 프로젝트 가상환경에서 사용할 목적이면 해당 환경의 Python 실행 파일을 지정하세요. uv·Poetry 프로젝트는 각 도구가 관리하는 실행·의존성 흐름을 따릅니다.
uv의 설치·기본 프로젝트 관리와 Poetry의 설치·가상환경 관리를 확인할 수 있습니다. 무엇을 사용할지 고르는 단계라면 pip·uv·Poetry 비교에서 기존 프로젝트와 목적에 맞는 경로를 선택하세요.
4. Python과 웹 프레임워크·서버 구분
FastAPI·Django는 Python으로 웹 요청을 처리하도록 돕는 프레임워크입니다. Python 실행기를 설치한 것과 앱의 패키지·서버·설정이 준비된 것은 다릅니다. 프로젝트가 요구하는 Python과 패키지를 같은 환경에 맞추세요.
개발 서버·자동 재시작은 로컬 코드 확인을 위한 기능입니다. 운영에는 해당 프레임워크가 지원하는 서버·프로세스·접속·DB·파일 구성을 별도로 준비합니다. FastAPI·Django 비교에서 API 중심과 통합 웹 개발 중 필요한 범위를 고를 수 있습니다.
5. 린트·서식·타입 검사·테스트 구분
| 작업 | 역할 |
|---|---|
| 린트 | 설정한 코드 규칙·문제 패턴 확인 |
| 포맷 | 들여쓰기·줄바꿈 등 서식 정리 |
| 타입 검사 | 정적 타입 관계 확인 |
| 실행 테스트 | 입력과 기대 동작 확인 |
Ruff는 린트와 포맷 명령을 구분하고, Black은 코드 서식 통일을 맡습니다. 어떤 도구든 검사 통과를 나머지 검증 전체의 완료로 보지는 않습니다. 도구를 설치한 환경·실행 버전과 프로젝트가 지원할 Python 문법 조건도 확인하세요. Ruff·Black 비교에서 기존 프로젝트의 포맷·린트 구성을 고를 수 있습니다.
6. 주요 기능
- 자동화·웹·데이터 분석·AI에 쓰는 범용 언어
- 무료 오픈소스 라이선스와 상업적 이용
- pip와 Python Package Index 기반 패키지 생태계
- venv로 프로젝트별 패키지 환경 분리
- 공식 설치판의 기본 편집기 IDLE
- Windows·macOS·Linux 지원
- 읽기 쉬운 문법 — 입문 언어 표준
7. 시스템 요구사항
- Windows
- Python Install Manager 기준 Windows 10 또는 Windows Server 2022 이상
- macOS
- 현재 python.org universal2 설치 파일의 Read Me에 표시된 지원 버전 확인 (통상 macOS 10.15 이상)
- Linux
- 배포판 패키지 관리자 또는 공식 소스 빌드 환경
- 권한·네트워크
- 설치 권한; 온라인 다운로드 또는 사전에 준비한 런타임·패키지 파일
- 프로젝트
- 패키지 충돌 방지를 위한 venv 가상환경 권장
8. 설치 방법
- 1.
공식 다운로드 페이지에서 운영체제를 선택합니다. Windows는 Python Install Manager, macOS는 현재 안정판 `.pkg`, Linux는 배포판 패키지를 우선 확인합니다.
- 2.
Windows에서는 Manager 설치 후 터미널에서 `python`을 실행하거나 프로젝트가 요구하는 버전을 설치합니다. `py install 3.14`는 3.14 계열을 지정하는 예입니다.
- 3.
macOS에서는 설치 패키지 실행을 마친 뒤 생성된 폴더에서 인증서 설치 명령 파일을 실행합니다.
- 4.
터미널에서 Windows는 `py -V`, macOS·Linux는 `python3 --version`으로 설치 결과를 확인합니다.
- 5.
프로젝트에서 사용할 Python으로 `.venv`를 만듭니다. 가상환경의 Python 실행 파일을 지정해 실행하고 같은 파일의 `-m pip`로 패키지를 설치하세요. 활성화는 편의를 위한 선택 사항입니다.
9. 자주 발생하는 문제
Windows에서 python 또는 py 명령이 열리지 않을 때
Python Install Manager가 설치되어 있는지 확인한 뒤 `py install --refresh`로 명령 별칭을 새로 고치세요. Windows의 앱 실행 별칭과 `%LocalAppData%\Microsoft\WindowsApps` 경로도 확인하고, 예전 Python Launcher와 명령이 충돌하면 구형 Launcher를 제거합니다.
pip 명령을 찾지 못하거나 다른 Python에 설치될 때
프로젝트에 설치하려면 해당 가상환경의 Python 실행 파일에 `-m pip`를 붙여 호출하세요. Windows는 `.venv\Scripts\python.exe`, macOS·Linux는 `.venv/bin/python`처럼 환경 안의 경로를 지정할 수 있습니다. 활성화했다면 `python -m pip`를 쓰되 실행 경로와 pip의 설치 위치를 함께 확인하세요.
macOS에서 HTTPS 인증서 오류가 날 때
python.org 설치판이라면 응용 프로그램의 Python 3.14 폴더에서 `Install Certificates.command`를 실행하고 완료 메시지를 확인하세요. Apple이 관리하는 시스템 Python은 삭제하거나 덮어쓰지 마세요.
Linux에서 패키지 설치 권한 오류가 날 때
시스템 Python에 `sudo pip`로 설치하지 말고 프로젝트에 `.venv`를 만든 뒤 해당 환경의 Python으로 패키지를 설치하세요. 운영체제 구성요소가 쓰는 Python 패키지를 덮어쓰면 시스템 도구가 고장날 수 있습니다.
10. 파이썬 (Python)와 비슷한 프로그램 비교
- 아나콘다 (Anaconda)
- Python·conda·Navigator와 분석 패키지를 묶은 배포판입니다. 필요한 도구가 미리 구성되지만 용량과 Anaconda 저장소·조직 사용 조건도 확인해야 합니다.
- 구글 코랩 (Colab)
- 설치 없이 브라우저에서 파이썬을 실행하는 구글 서비스. 학습·실습용으로는 설치 전 대안이 됩니다.
- VS Code
- 파이썬 자체가 아니라 코드를 작성하는 에디터. 파이썬 설치 후 함께 쓰는 표준 조합입니다.
11. 자주 묻는 질문
파이썬은 무료인가요?
+
네. Python Software Foundation License로 배포되는 무료 오픈소스이며 개인 학습과 회사·상업 프로젝트에 사용할 수 있습니다. 함께 설치하는 제3자 패키지는 각각의 라이선스를 별도로 확인해야 합니다.
어떤 버전을 받아야 하나요?
+
2026년 11월 확인한 최신 안정판은 3.15.2입니다. 새 프로젝트는 최신판의 기능과 필요한 패키지 지원을 함께 검토하고, 강의·회사 프로젝트가 특정 버전을 요구하면 그 조건을 따르세요. 3.14 계열도 유지 중이므로 기존 환경을 바로 업그레이드할 필요는 없습니다. 3.15를 시험판으로만 안내하는 오래된 글과 구분하세요.
설치했는데 cmd에서 python이 인식되지 않아요.
+
현재 Windows 권장 방식인 Python Install Manager에서는 예전 설치 화면의 PATH 체크박스를 찾을 필요가 없습니다. Manager 설치 여부를 확인하고 `py install --refresh`를 실행한 뒤 앱 실행 별칭과 WindowsApps 경로를 점검하세요.
Microsoft Store 버전과 공식 인스톨러의 차이는요?
+
Microsoft Store와 python.org에서 제공하는 Python Install Manager의 기능은 같습니다. Store 사용이 제한된 환경에서는 python.org 배포 파일을 확인하세요. 다만 Manager 설치 파일만으로 오프라인 런타임 설치까지 준비되는 것은 아닙니다. 인터넷이 없는 PC는 런타임 파일도 미리 준비해야 합니다.
파이썬을 인터넷 없이 설치할 수 있나요?
+
Windows Install Manager 방식에서는 인터넷이 되는 PC에서 사용할 버전의 런타임과 offline index를 미리 내려받고, 해당 폴더 전체와 Manager 설치 파일을 대상 PC로 옮겨야 합니다. 추가 pip 패키지와 그 의존성은 별도 준비 대상입니다. 아래 공식 오프라인 설치 문서에서 런타임 준비 조건을 확인하세요.
embeddable ZIP을 일반 설치 대신 써도 되나요?
+
embeddable 배포판은 다른 앱에 Python을 포함하기 위한 최소 환경입니다. Tcl/Tk·IDLE·pip·문서가 없고, 일반 설치처럼 pip로 의존성을 관리하는 방식은 지원되지 않습니다. 처음 배우거나 보통의 개발 환경을 만들 목적이라면 Python Install Manager를 선택하세요.
맥에는 파이썬이 기본으로 깔려 있지 않나요?
+
최근 macOS에는 Apple 개발 도구가 관리하는 `/usr/bin/python3`가 있을 수 있지만 보통 오래되고 불완전하며 사용자가 수정·삭제하면 안 됩니다. 개발용 최신 Python은 python.org 설치판이나 신뢰하는 패키지 관리자로 별도 설치하세요.
아나콘다랑 뭐가 다른가요?
+
Python은 언어와 실행 환경이고, Anaconda Distribution은 Python·conda·Navigator와 분석 패키지를 묶은 배포판입니다. 수업·프로젝트가 묶음 환경을 요구할 때 비교하세요. Python 자체의 무료 라이선스와 Anaconda 저장소·조직 사용 조건은 별개입니다. 구성과 무료 범위는 아나콘다 페이지에서 확인할 수 있습니다.
프로젝트마다 가상환경을 만들어야 하나요?
+
프로젝트별로 다른 패키지나 버전을 쓰면 .venv로 설치 위치를 분리하는 것이 좋습니다. 활성화가 필수는 아니며 해당 환경의 Python 실행 파일을 명시해 실행할 수 있습니다. 가상환경 만들고 Python·pip 경로 확인하기에서 Windows PowerShell의 생성·실행·설치 위치 대조를 확인하세요.
Python을 설치하면 uv나 Poetry도 필요한가요?
+
항상 필요한 것은 아닙니다. 기본 venv·pip로 시작할 수 있고, 프로젝트 단위 의존성·잠금·실행 관리가 필요하거나 기존 프로젝트가 지정한 경우 uv·Poetry를 선택할 수 있습니다. Python 인터프리터와 패키지 관리 도구의 역할은 다릅니다.
Python만 설치하면 웹 앱도 실행되나요?
+
앱이 요구하는 프레임워크·의존성·서버·설정을 프로젝트 환경에 준비해야 합니다. 개발 서버와 운영 배포도 구분하세요.
12. 참고 자료
- Python 공식 다운로드 페이지
- Python 버전 지원 현황 - Python Developer Guide
- Windows에서 Python 사용하기 - Python 3.14 문서
- macOS에서 Python 사용하기 - Python 3.14 문서
- Unix에서 Python 사용하기 - Python 3.14 문서
- Python 모듈 설치 공식 문서
- Windows 오프라인 런타임 설치 - Python 공식 문서
- embeddable 배포판의 용도와 제한 - Python 공식 문서
- Python 3.15.2 공식 안정판 릴리스
- Python 공식 venv — 생성·활성화 선택·실행 경로
- PyPA 패키지 설치 — 환경 분리와 같은 Python의 pip
- Anaconda — Distribution과 Miniconda 구성
- Anaconda — 현재 무료 사용·조직 조건
- Python — 가상환경과 패키지 역할
- pip — 패키지 설치와 프로젝트 관리의 경계
- uv — 제품·기능과 개발 주체
- Poetry — 공식 설치·요구사항
- FastAPI 서버·운영
- Django 실행·DB 준비
- 타입 검사와 차이
- Ruff 린터
- Black 검사·설정
관련 프로그램