# 파이썬 설치 방법: Windows, macOS, Linux에서 단계별로 설치하기

URL: https://skillaria.top/ko/guides/python/install-python

파이썬은 python.org의 Downloads 페이지에서 무료로 내려받거나, uv 관리자 도구로 python install 3.15 명령 한 줄에 설치할 수 있습니다. Windows에서는 설치 과정에서 Add python.exe to PATH를 꼭 체크하고, macOS에서는 python.org의 .pkg 패키지나 Homebrew를, Linux에서는 배포판의 패키지 관리자나 uv를 사용하세요. 설치 확인은 python3 --version 명령으로 합니다.

파이썬은 python.org에서 무료로 내려받거나, uv 도구로 명령 한 줄에 설치할 수 있습니다. 이 글에서는 Windows, macOS, Linux에서 설치하는 단계, 버전 확인, 대화형 콘솔 REPL과 IDLE 편집기 사용법, 그리고 첫 스크립트를 실행하는 방법을 정리했습니다. 전체 과정은 약 10분이면 끝납니다.

## 파이썬을 무료로 안전하게 받는 곳

파이썬은 자유 소프트웨어이므로 돈을 낼 필요가 없습니다. 공식 출처는 python.org 한 곳이며, Downloads 메뉴에 Windows와 macOS용 설치 파일과 소스 코드가 있습니다. 파일 공유 사이트에서 떠도는 '파이썬 빌드'는 받지 않는 것이 좋습니다. 어떤 코드가 들어 있는지 알 수 없기 때문입니다.

두 번째 방법은 Astral사의 uv입니다. 요즘 많은 프로젝트가 선택하는 방식입니다. uv 하나로 필요한 파이썬 버전을 내려받고, 가상 환경을 만들고, 라이브러리를 설치합니다. pyenv, pip, venv, pipx, poetry를 한꺼번에 대신하며, 시스템에 깔린 파이썬은 건드리지 않습니다.

| 방법 | 장점 | 추천 대상 |
| --- | --- | --- |

| python.org 설치 파일 | 공식 배포, IDLE과 문서 포함 | Windows와 macOS를 처음 쓰는 분 |

| uv | 원하는 버전을 명령 한 줄로 설치, 프로젝트별 환경, 시스템을 망가뜨리지 않음 | 모든 사용자, 특히 Linux와 여러 프로젝트를 동시에 다루는 경우 |

| OS 패키지 관리자 (apt, dnf, brew) | 익숙하고 시스템 업데이트와 함께 갱신됨 | 저장소의 버전이 충분할 때 |

## 어떤 파이썬 버전을 고를까

최신 안정 버전의 Python 3을 설치하세요. 새 버전은 매년 10월에 나오며, 이 글을 쓰는 시점의 최신 버전은 Python 3.15입니다. Python 2는 오래전에 지원이 끝났으므로, `print "hello"`처럼 괄호 없이 쓴 예제는 이미 옛날 문법입니다.

'검증된 예전 버전을 쓰는 게 안전하다'는 생각은 함정일 수 있습니다. 2026년 10월 기준으로 Python 3.10은 보안 수정도 받지 않습니다. 3.15용으로 작성한 코드는 예전 버전에서 실행되지 않을 수 있지만, Python 3 계열 안에서는 하위 호환성이 좋은 편이므로 최신 버전을 고르는 것이 대부분 가장 좋은 선택입니다.

## Windows에 파이썬 설치하기

### python.org 설치 파일 사용

1. python.org에 접속해 Downloads 메뉴에서 Windows용 설치 파일을 받으세요(64-bit 버전이면 대부분의 컴퓨터에 맞습니다).
2. 파일을 실행합니다. 첫 화면에서 **Add python.exe to PATH**를 반드시 체크하세요. 체크하지 않으면 터미널에서 `python` 명령을 찾을 수 없습니다.
3. **Install Now**를 누르고 설치가 끝날 때까지 기다립니다.
4. 새 PowerShell 또는 명령 프롬프트 창을 열고 버전을 확인합니다.

```
PS C:\Users\anna> python --version
Python 3.15.0
PS C:\Users\anna> py --list
 -V:3.15 *        Python 3.15 (64-bit)
```

`py`는 Windows용 파이썬 런처입니다. 설치된 모든 버전을 알고 있으며, 예를 들어 `py -3.15 script.py`처럼 원하는 버전을 골라 실행할 수 있습니다. 최근 python.org는 Windows용 새 설치 관리자(Python install manager)도 안내하는데, 다운로드 페이지에 보이면 화면의 안내를 따르면 됩니다. 원리는 같습니다.

### PowerShell로 파이썬 설치하기

브라우저 없이 Windows 10과 Windows 11에 파이썬을 설치하려면 uv가 편합니다. 먼저 공식 스크립트로 uv를 설치하고, 그다음 원하는 버전을 설치합니다.

```
PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
PS> uv python install 3.15
PS> uv run --python 3.15 python --version
Python 3.15.0
```

또 다른 방법은 Windows의 패키지 관리자 `winget`입니다. `winget search Python.Python`으로 사용할 수 있는 버전을 확인한 뒤, 찾은 ID로 `winget install`을 실행하면 됩니다.

### 자주 겪는 문제: Microsoft Store가 열림

`python`을 입력했는데 파이썬 대신 Microsoft Store가 열린다면, 파이썬이 PATH에 등록되지 않았고 Windows의 기본 연결 프로그램이 대신 실행된 것입니다. Add python.exe to PATH를 체크하고 다시 설치하거나, '설정 → 앱 → 고급 앱 설정 → 앱 실행 별칭'에서 python 항목을 끄세요. PATH를 바꾼 뒤에는 항상 새 터미널 창을 여세요.

## macOS에 파이썬 설치하기

macOS에서는 `python3` 명령이 이미 있을 수 있습니다. 대개 시스템에 포함된 오래된 버전이거나, Xcode 개발자 도구가 설치하는 자리 표시자입니다. 공부용으로는 최신 버전을 아래 방법 중 하나로 설치하세요.

- **python.org 패키지** — macOS용 설치 파일(`.pkg`, Intel과 Apple Silicon 모두 지원)을 받아 설치 마법사를 따라가세요. Python과 함께 IDLE도 설치됩니다.
- **Homebrew** — 이미 쓰고 있다면 `brew install python`을 실행하세요.
- **uv** — 공식 스크립트로 uv를 설치한 뒤 버전을 지정해 설치하세요.

```
$ curl -LsSf https://astral.sh/uv/install.sh | sh
$ uv python install 3.15
$ uv run --python 3.15 python --version
Python 3.15.0
```

macOS와 Linux에서는 `python3` 명령을 사용하세요. `python`이라는 이름은 없거나 다른 프로그램을 가리킬 수 있습니다.

## Linux에 파이썬 설치하기: Ubuntu, Debian 등

Linux에는 보통 파이썬이 이미 깔려 있지만, 이는 운영체제가 쓰는 시스템 인터프리터입니다. 버전이 몇 년 뒤처져 있는 경우가 많습니다. Ubuntu 24.04에는 Python 3.12가, Debian 12에는 3.11이 들어 있습니다. 시스템 파이썬을 업데이트하거나 삭제하지 마세요. 패키지 관리자가 망가질 수 있습니다.

저장소의 버전으로 충분하다면, 가상 환경 모듈과 pip와 함께 설치하세요.

```
$ sudo apt update
$ sudo apt install python3 python3-venv python3-pip
$ python3 --version
Python 3.12.3
```

Fedora나 RHEL 계열에서는 `sudo dnf install python3`으로 같은 일을 합니다. 시스템 버전보다 새 버전이 필요하다면 uv가 가장 편합니다. uv는 인터프리터를 홈 디렉터리의 자기 폴더에 설치하며, 시스템은 건드리지 않습니다.

```
$ curl -LsSf https://astral.sh/uv/install.sh | sh
$ uv python install 3.15
$ uv python find 3.15
/home/lena/.local/share/uv/python/cpython-3.15.0/bin/python3.15
```

### sudo pip install을 하면 안 되는 이유

시스템 파이썬에 `sudo pip install`로 라이브러리를 설치하면 apt가 깨지는 지름길입니다. 그래서 PEP 668에 따라 최신 배포판은 이런 설치를 `externally-managed-environment` 오류와 함께 막습니다. 올바른 방법은 프로젝트별 가상 환경을 만드는 것입니다. 아래에서 다시 설명합니다.

## 파이썬 설치 확인하기

설치가 끝나면 새 터미널을 열고 다음 명령으로 확인하세요. 운영체제별 명령은 다음과 같습니다.

| 확인 항목 | Windows | macOS / Linux |
| --- | --- | --- |

| 파이썬 버전 | `python --version` 또는 `py --version` | `python3 --version` |

| 인터프리터 위치 | `where python` | `which python3` |

| pip 버전 | `py -m pip --version` | `python3 -m pip --version` |

| 파이썬 내부에서 버전 보기 | `import sys; print(sys.version)` | `import sys; print(sys.version)` |

### 'python'과 'python3'은 서로 다른 프로그램일 수 있습니다

처음 파이썬을 설치한 사람이 흔히 겪는 일이 있습니다. 최신 버전을 설치하고 새 문법으로 코드를 작성했는데 `SyntaxError`가 나는 경우입니다. 터미널이 옛날 버전을 호출했기 때문입니다. 한 컴퓨터에 버전이 서너 개 있는 경우도 많습니다. 경로는 `which python3`(Windows에서는 `where python`)로 확인하고, 프로젝트에서는 `uv run`으로 실행하세요. uv는 항상 프로젝트가 지정한 버전을 사용합니다.

## 파이썬 업데이트 방법

파이썬은 마이너 버전 사이에서 '덮어쓰기' 업데이트가 되지 않습니다. 3.14와 3.15는 서로 다른 프로그램으로 나란히 존재합니다. 새 버전으로 바꾸려면 같은 방법으로 새 버전을 설치하세요. python.org 설치 파일을 쓰거나, `brew upgrade python`을 실행하거나, `uv python install 3.15`를 실행하면 됩니다. 그다음 프로젝트의 가상 환경을 새 버전으로 다시 만드세요. 같은 버전 안의 수정 릴리스(3.15.0 → 3.15.1)는 python.org 설치 파일이 기존 버전 위에 설치해 줍니다.

## REPL: 파이썬 대화형 콘솔

파이썬을 가장 빨리 체험하는 방법은 대화형 콘솔, 즉 REPL(Read–Eval–Print Loop: 읽고, 실행하고, 출력하고, 반복하기)입니다. 파일 없이 인터프리터만 실행하면 `>>>` 프롬프트가 나타납니다.

```
$ python3
Python 3.15.0 ...
>>> 2 + 3
5
>>> name = "커피"
>>> name.upper()
'커피'
>>> exit
```

콘솔을 나가려면 `exit`를 입력하거나 Ctrl+D를 누르세요(Windows에서는 Ctrl+Z 후 Enter). 3.13부터 콘솔은 훨씬 편해졌습니다. 프롬프트와 트레이스백에 색이 입혀지고, 여러 줄 블록을 한꺼번에 편집할 수 있으며, F1은 도움말, F2는 명령 기록, F3은 붙여넣기 모드입니다. `exit`와 `quit`는 괄호 없이 입력해도 됩니다. 3.14에서는 입력하는 동안 코드 강조와, `import` 뒤에서 Tab으로 모듈 이름 자동 완성이 추가되었습니다. 예전의 단순한 콘솔이 필요하면 환경 변수 `PYTHON_BASIC_REPL=1`을 설정하세요.

## IDLE: 기본으로 제공되는 간단한 편집기

Windows와 macOS용 python.org 설치 파일에는 IDLE이 함께 들어 있습니다. 콘솔이 붙은 작은 편집기입니다. 시작 메뉴나 '프로그램' 목록(Python 3.15 폴더)에서 찾을 수 있습니다. IDLE에는 두 개의 창이 있습니다. Shell은 `>>>` 콘솔이고, 파일 편집기는 File → New File로 엽니다. 코드를 쓰고 저장한 뒤 F5(Run → Run Module)를 누르면 실행됩니다. Linux에서는 IDLE이 보통 별도 패키지이며, Debian과 Ubuntu에서는 `sudo apt install idle3`로 설치합니다.

처음 몇 주에는 IDLE로 충분합니다. 프로젝트가 커지면 VS Code나 PyCharm 같은 편집기로 옮기면 되고, 인터프리터는 그대로 사용하면 됩니다.

## 첫 파이썬 스크립트

콘솔은 실험할 때 좋고, 실제 프로그램은 파일에 씁니다. 스크립트는 `.py` 확장자를 가진 일반 텍스트 파일이며, 인터프리터가 위에서 아래로 실행합니다. `expenses.py` 파일을 만드세요.

```
item = "커피"
amount = 250
print(item, amount)
```

파일이 있는 폴더에서 실행하세요.

```
$ python3 expenses.py
커피 250
```

Windows에서는 `python expenses.py` 또는 `py expenses.py`를, uv로 실행할 때는 `uv run expenses.py`를 사용합니다. `can't open file` 메시지가 보이면 파일이 있는 폴더가 아닌 곳에 있는 것이므로 `cd` 명령으로 이동하세요.

## 가상 환경이 있는 프로젝트

가상 환경은 `.venv` 폴더 안에 자체 파이썬과 라이브러리를 담아 두는 독립된 공간입니다. 덕분에 한 프로젝트의 의존성이 다른 프로젝트와 섞이지 않습니다. uv를 쓰면 명령 한 줄로 프로젝트를 만듭니다.

```
$ uv init expenses --python 3.15
Initialized project `expenses`
$ cd expenses && ls -a
.python-version  README.md  main.py  pyproject.toml
$ uv run main.py
Hello from expenses!
```

`pyproject.toml`은 프로젝트의 명세서이고, `.python-version`은 버전을 고정합니다. `.venv`는 처음 실행할 때 uv가 만듭니다. uv 없이 가상 환경을 만들려면 표준 모듈을 사용합니다. `python3 -m venv .venv`를 실행하고, `source .venv/bin/activate`(Windows에서는 `.venv\Scripts\activate`)로 활성화한 뒤 `pip install`로 라이브러리를 설치하세요.

## 파이썬 설치 시 자주 나는 오류

| 증상 | 원인 | 해결 방법 |
| --- | --- | --- |

| Windows에서 `'python' is not recognized` | Python이 PATH에 없음 | Add python.exe to PATH를 체크해 다시 설치하거나 `py`로 실행 |

| Linux에서 `python3: command not found` | Python이 설치되지 않음 (최소 이미지, 컨테이너) | `sudo apt install python3` 또는 uv 사용 |

| `No module named pip` | Python과 함께 pip가 설치되지 않음 | `python3 -m ensurepip --upgrade` 실행 또는 `python3-pip` 패키지 설치 |

| `externally-managed-environment` | 시스템 파이썬에 라이브러리를 설치하려고 함 (PEP 668) | 가상 환경을 만들고 그 안에 패키지 설치 |

| 설치 후에도 옛날 버전이 실행됨 | 설치 전에 열어 둔 터미널이거나, PATH 맨 앞에 다른 파이썬이 있음 | 새 터미널을 열고 `which python3` 또는 `where python`으로 확인 |

설치 문제의 대부분은 PATH와 여러 버전이 섞인 상황에서 생깁니다. 지금 어떤 인터프리터가 실행되는지 모르겠다면 `python3 -c "import sys; print(sys.executable)"`를 실행하세요. 사용 중인 인터프리터의 전체 경로가 출력됩니다.

## 정리

파이썬은 python.org나 uv로 설치하는 것이 가장 안전합니다. Windows에서는 PATH 체크박스를 잊지 마세요. Linux에서는 시스템 인터프리터를 건드리지 마세요. 설치 후 버전을 확인하고, REPL과 IDLE을 써 보고, 첫 스크립트를 실행해 보세요. 그다음 변수, 문자열, 조건문으로 넘어가면 됩니다. 이 글에서 다룬 Python 3.15 설치, 콘솔 사용, uv로 만드는 첫 프로젝트는 과정의 첫 강의에서 실습으로 다룹니다.

## FAQ

**파이썬은 유료인가요?**

아닙니다. 파이썬은 PSF 라이선스에 따라 무료로 배포되며, 상업 프로젝트에서도 자유롭게 사용할 수 있습니다.

**새 버전을 설치하기 전에 예전 버전을 삭제해야 하나요?**

아닙니다. 여러 버전은 서로 문제없이 함께 설치됩니다. Linux와 macOS의 시스템 파이썬은 운영체제가 사용하므로 삭제하면 안 됩니다.

**관리자 권한 없이 파이썬을 설치할 수 있나요?**

네. Windows용 python.org 설치 파일은 현재 사용자에게만 설치할 수 있고, uv는 항상 홈 디렉터리에 인터프리터를 설치합니다.

**python 명령을 찾을 수 없다고 나오면 어떻게 하나요?**

파이썬이 PATH에 등록되지 않은 것입니다. Add python.exe to PATH를 체크해 다시 설치하거나, Windows에서는 py, macOS와 Linux에서는 python3을 사용하세요. 그다음 새 터미널을 여세요.

**파이썬은 용량을 얼마나 차지하나요?**

표준 라이브러리를 포함한 인터프리터는 대략 100MB 정도입니다. 실제로 많은 공간을 차지하는 것은 가상 환경에 설치하는 라이브러리입니다.


---
Source: Skillaria.Top (https://skillaria.top)