파이썬(Python) 다운로드 및 설치 방법 (윈도우 PATH 설정·맥)

설치 전에 알아둘 것

파이썬은 python.org 에서 무료로 받을 수 있는 오픈소스 언어입니다. 검색 결과에는 '파이썬 무료 다운로드'를 내세운 자료실이나 블로그 첨부 파일이 많이 보이지만, 설치 파일은 반드시 공식 사이트에서 받는 것이 좋습니다. 이 페이지의 다운로드 버튼은 python.org 의 Downloads 페이지로 연결됩니다.

윈도우 설치 방식은 최근 크게 바뀌었습니다. 예전에는 버전별 설치 파일 하나를 받아 실행했지만, 지금 공식 Downloads 페이지의 첫 버튼은 Download Python install manager 입니다. 이 설치 관리자가 파이썬 본체를 내려받고 여러 버전을 관리해 줍니다. 기존 방식의 단독 설치 파일도 버튼 바로 아래 링크로 계속 제공되지만, 공식 문서는 앞으로 단독 설치 파일 배포를 단계적으로 중단한다고 밝히고 있습니다.

• 운영체제: 윈도우 10 이상 권장, 최근 macOS, 주요 리눅스 배포판
• 학교·회사 PC라면 설치 권한과 프로그램 설치 정책을 먼저 확인
• 이미 다른 방법(아나콘다, 스토어 등)으로 파이썬을 설치했다면 어느 것을 쓸지 먼저 정하기
• 명령 프롬프트(또는 PowerShell)와 터미널을 여는 방법 알아 두기

윈도우: Python install manager 로 설치하기

공식 문서가 권장하는 새로운 방식입니다. 설치 관리자를 한 번 설치해 두면 python, py, pymanager 세 가지 명령을 쓸 수 있고, 새 버전 추가와 삭제도 명령 한 줄로 처리됩니다. 공식 문서에 따르면 Microsoft Store 의 Python install manager 도 python.org 에서 받는 것과 동일합니다.

1. 공식 Downloads 페이지에서 Download Python install manager 버튼을 눌러 설치 파일(.msix)을 받습니다.
2. 받은 파일을 더블 클릭하고 창이 뜨면 Install 을 누릅니다. 스토어에서 설치할 때는 받기 또는 설치 를 누르면 됩니다.
3. 설치가 끝나면 명령 프롬프트나 PowerShell 을 새로 열고 python 을 입력합니다. 아직 파이썬 본체가 없다면 최신 버전을 설치할지 묻는 안내가 나옵니다.
4. 처음 런타임을 설치할 때 PATH 에 폴더를 추가할지 묻는 경우가 있습니다. py 명령만 쓸 계획이면 선택 사항이지만, 초보자라면 안내에 따라 추가해 두는 편이 편합니다.
5. py list 를 입력해 설치된 버전 목록과 기본 버전을 확인합니다.

윈도우: 기존 단독 설치 파일로 설치하기 (Add python.exe to PATH)

회사 표준이나 강의 자료가 기존 설치 파일을 기준으로 하고 있다면 Downloads 페이지의 Or get the standalone installer for Python 링크, 또는 Windows 전용 다운로드 페이지의 Windows installer (64-bit) 를 받습니다. 대부분의 PC는 64비트 설치 파일이 맞고, ARM 프로세서 노트북은 ARM64 설치 파일을 고릅니다.

이 방식에서 가장 중요한 것은 첫 화면 아래의 체크 상자입니다. Add python.exe to PATH 를 체크하지 않고 설치하면 명령 프롬프트에서 python 을 입력해도 '내부 또는 외부 명령이 아닙니다'라는 오류가 납니다.

1. 받은 python-버전-amd64.exe 파일을 실행합니다.
2. 첫 화면 아래쪽 Add python.exe to PATH 를 체크합니다.
3. 특별한 이유가 없다면 Install Now 를 누릅니다. 설치 위치를 바꾸거나 모든 사용자용으로 설치하려면 Customize installation 을 고릅니다.
4. 사용자 계정 컨트롤 창이 뜨면 예 를 누르고 설치가 끝날 때까지 기다립니다.
5. 마지막 화면에 Disable path length limit 이 보이면 눌러 두세요. 긴 폴더 경로에서 생기는 오류를 줄여 줍니다.
6. Close 를 누르고 명령 프롬프트를 새로 열어 python --version 을 입력해 확인합니다.

맥에서 파이썬 설치하기

맥에는 애플이 개발 도구용으로 넣어 둔 python3 가 있을 수 있지만, 학습이나 개발에는 python.org 의 공식 설치 파일을 따로 설치하는 것이 일반적입니다. 공식 맥 설치 파일은 애플 실리콘과 인텔 맥을 모두 지원하는 유니버설 형식입니다.

1. 공식 Downloads 페이지에서 Download Python 버튼을 눌러 .pkg 파일을 받습니다.
2. 받은 파일을 열고 계속, 동의, 설치 순으로 진행한 뒤 맥 로그인 암호를 입력합니다.
3. 설치가 끝나면 응용 프로그램 폴더 안에 Python 버전 폴더가 생기고 Finder 창이 자동으로 열립니다.
4. 그 폴더의 Install Certificates.command 를 더블 클릭해 실행합니다. 이 과정을 건너뛰면 인터넷에서 데이터를 받을 때 인증서 오류가 날 수 있습니다.
5. 터미널을 열고 python3 --version 을 입력해 설치한 버전이 표시되는지 확인합니다.

설치 후 첫 설정: pip 확인과 가상환경 만들기

설치가 끝났다면 패키지 관리자 pip 가 잘 동작하는지 확인하고, 연습용 프로젝트 폴더에 가상환경을 하나 만들어 두세요. 가상환경을 쓰면 프로젝트마다 필요한 패키지를 따로 관리할 수 있어 나중에 버전 충돌을 피할 수 있습니다.

1. python -m pip --version 을 입력해 pip 버전이 표시되는지 확인합니다(맥은 python3 -m pip --version).
2. 작업할 폴더로 이동한 뒤 python -m venv .venv 로 가상환경을 만듭니다.
3. 윈도우는 .venv\Scripts\activate, 맥·리눅스는 source .venv/bin/activate 로 가상환경을 켭니다. 프롬프트 앞에 (.venv) 가 붙으면 성공입니다.
4. pip install requests 처럼 필요한 패키지를 설치합니다.
5. 작업이 끝나면 deactivate 로 가상환경을 빠져나옵니다.

설치가 안 되거나 명령이 인식되지 않을 때

설치 자체보다 설치 후 명령이 인식되지 않는 문제가 훨씬 흔합니다. 아래 항목을 순서대로 확인하고, 해결되지 않으면 이 프로그램의 오류 해결 가이드를 참고하세요.

• 명령 프롬프트를 설치 전부터 열어 두었다면 창을 닫고 새로 여세요. PATH 변경은 새 창에서만 반영됩니다.
• python 을 입력했는데 Microsoft Store 가 열린다면 설정 > 앱 > 고급 앱 설정 > 앱 실행 별칭 에서 파이썬 관련 별칭 상태를 확인하세요.
• 기존 단독 설치 파일로 설치했는데 PATH 체크를 빠뜨렸다면 설치 파일의 Modify 로 환경 변수 옵션을 켭니다.
• 회사 PC에서 설치 파일이 막힌다면 보안 정책 때문일 수 있으니 IT 담당자에게 문의하세요.

자주 묻는 질문

작성·관리 공식유틸 다운로드 운영자 · 작성 기준과 정정 절차 · 오류 제보