본문 바로가기

개발노트

파이썬(Python) 설치 및 환경변수 설정 방법(windows 11 기준)

반응형

파이썬(Python)은 웹 개발, 데이터 분석, 인공지능, 자동화 등 다양한 분야에서 사용되는 프로그래밍 언어이다.

 

파이썬을 이용하여 개발을 시작하려면 가장 먼저 Python을 설치하고 환경변수(PATH)를 설정해야 한다.

 

이번 글에서는 Windows 11 환경에서 Python을 설치하고 환경변수를 설정한 뒤 정상적으로 실행되는지 확인하는 방법까지 정리해 보겠다.

 

파이썬(Python) 설치하기

파이썬(Python) 로고

 

아래의 파이썬(Python) 공식 홈페이지에 접속하여 최신 버전의 Python 설치 파일을 다운로드해보자.

 

https://www.python.org/downloads/windows/

 

Python Releases for Windows

The official home of the Python Programming Language

www.python.org

 

Windows 사용자는 Windows Installer(64-bit)를 선택하여 다운로드하면 된다.

 

다운로드한 설치 파일을 실행하면 설치 화면이 나타나는데 이때 아래 옵션을 반드시 체크한다.

  • Add Python to PATH

해당 옵션을 선택한 후 Install Now를 클릭하여 설치를 진행하고 설치가 완료되면 Close 버튼을 눌러 종료한다.

 

PATH 환경변수 설정

파이썬(Python) 설치 과정에서 Add Python to PATH 옵션을 선택했다면 대부분 별도의 환경변수 설정 없이 사용할 수 있다.

 

만약 해당 옵션을 선택하지 않았다면 Python 명령어가 정상적으로 동작하지 않을 수 있다.

 

따라서 설치 과정에서 Add Python to PATH 옵션을 체크하는 것을 추천한다.

 

Python 설치 확인

설치가 완료되었다면 명령 프롬프트(Command Prompt)를 실행한다.

 

아래 명령어를 입력한다.

 

python --version

 

버전 정보가 정상적으로 출력된다면 Python 설치가 완료된 것이다.

 

예시

Python 3.13.5

 

파이썬 버전 확인 방법
파이썬 버전 확인

 

pip 설치 확인

파이썬(Python)에는 패키지를 관리하기 위한 pip가 기본적으로 포함되어 있다.

 

명령 프롬프트에서 아래 명령어를 입력한다.

 

python -m pip --version

 

정상적으로 설치되어 있다면 버전 정보가 출력된다.

 

예시

 

pip 25.1.1 from C:\Users\사용자명\AppData\Local\Programs\Python\Python313\Lib\site-packages\pip (python 3.13)

 

파이썬 파이프 버전 확인
파이썬 파이프 버전 확인

 

IDLE 실행 확인

파이썬 설치가 완료되면 시작 메뉴에서 IDLE(Python)을 실행할 수 있다.

 

파이썬 IDLE 실행
파이썬 IDLE 실행

 

IDLE은 파이썬에 기본으로 포함되어 있는 간단한 개발 환경으로, 파이썬이 정상적으로 설치되었는지 확인하는 용도로 사용할 수 있다.

 

IDLE을 실행한 뒤 아래 코드를 입력해 보자.

 

print("Hello Python")

 

실행 결과

 

Hello Python

 

파이썬 IDLE 실행 결과
파이썬 IDLE 실행 결과

 

위와 같이 출력된다면 파이썬이 정상적으로 설치된 것이다.

 

반응형

 

명령어가 실행되지 않는다면?

아래 명령어를 입력했을 때 오류가 발생한다면 환경변수(PATH)가 제대로 설정되지 않았을 가능성이 있다.

 

python --version
pip --version

 

설치 과정에서 Add Python to PATH 옵션이 체크되어 있는지 다시 확인해 보자.

 

계속 해결이 안 될 경우 다음 사항을 하나씩 확인해봐야 한다.

설치된 패키지 확인

다음 명령어를 입력하고 패키지 목록이 나온다면 pip는 정상적으로 동작하는 상태다.

python -m pip list

 

파이썬 설치된 패키지 확인
파이썬 설치된 패키지 확인

 

pip 명령어만 안 되는 경우

python -m pip --version 은 되는데 pip --version 만 안 된다면, Script 폴더가 PATH 환경변수에 등록되지 않았을 가능성이 크므로 확인 후 환경변수에 등록하도록 하자.

 

Python 설치 위치에 따라 경로는 달라질 수 있는데 보통 아래 경로 2개 중 한 곳에 설치된다.

 

설치 위지를 확인하여 환경변수에 등록해 주면 된다.

 

C:\Users\사용자명\AppData\Local\Programs\Python\Python313\
C:\Program Files\Python313\

 

파이썬 환경변수 등록
파이썬 환경변수 등록

 

환경변수를 등록하고 명령 프롬프트를 재실행하여 pip --version 명령어를 입력해 보자. 

 

다음과 같이 나온다면 정상적으로 등록된 것이다.

 

파이썬 파이프(pip) 버전 확인
파이썬 파이프(pip) 버전 확인

 

pip가 설치 안 된 경우

아래 명령어를 실행하면 pip를 설치(또는 복구) 할 수 있다.

 

python -m ensurepip --upgrade

 

파이썬 설치가 완료되었다면 이제 개발 도구를 설치하여 본격적으로 개발을 시작할 수 있다.

 

정리하며

이번 글에서는 Windows 11 환경에서 파이썬을 설치하고 환경변수를 설정하는 방법을 알아보았다.

 

파이썬 개발을 시작하기 위한 가장 기본적인 과정인 만큼 한 번만 제대로 설정해 두면 이후에는 다양한 개발 도구와 연동하여 편하게 사용할 수 있다.

 

파이썬 설치와 개발 환경 세팅이 끝났다면 프로젝트별 개발 환경을 분리할 수 있는 가상 환경도 함께 알아두는 것이 좋다.

 

아래 글에서 아나콘다(Anaconda) 설치 및 사용 방법을 확인해보자.

 

▶ 파이썬(Python) 가상 환경 아나콘다(Anaconda) 설치 및 사용 방법

 

반응형