파이썬을 시작할 때 가장 많이 막히는 지점

작성자:

프로그래밍을 처음 시작하면 “파이썬 설치까지는 했는데, 명령 프롬프트에서 python이 안 먹힌다”라는 상황을 한 번쯤 겪습니다. 특히 환경 변수(Path) 설정은 개념 자체가 낯설어서 초보자들이 가장 많이 헷갈리는 부분입니다. 이 글에서는 파이썬 설치부터 환경 변수 설정, 그리고 설치 확인까지 한 번에 정리해 드립니다.

읽고 나면 다음을 직접 할 수 있습니다.

  • 윈도우에서 최신 파이썬 버전 다운로드
  • 설치 옵션에서 반드시 체크해야 할 항목 이해
  • 설치 후 환경 변수를 확인·수정하는 방법
  • python --version 으로 설치 여부 점검

파이썬

파이썬 설치 전에 알아두면 좋은 기본 개념

파이썬은 어떤 언어인가?

파이썬은 범용 프로그래밍 언어로, 웹 개발, 데이터 분석, 자동화 스크립트, 인공지능 등 다양한 분야에서 사용됩니다. 문법이 비교적 단순하고 읽기 쉬워 초보자 입문용으로 가장 많이 추천되는 언어 중 하나입니다.

또한 파이썬은 오픈 소스이며, 공식 배포판은 Python Software Foundation(PSF)에서 무료로 제공됩니다.

어떤 운영체제에서 사용할 수 있나?

파이썬 공식 사이트에서는 다음 운영체제용 설치 파일을 제공합니다.

  • Windows (윈도우 10, 윈도우 11 등)
  • macOS
  • Linux(리눅스)

이 글은 Windows 10/11 기준으로 설명하지만, “공식 사이트에서 최신 3.x 버전을 받는다”는 큰 흐름은 다른 OS에서도 동일합니다.

환경 변수(Path)란 무엇인가?

환경 변수 중 PATH는 운영체제가 “실행 파일을 어디서 찾을지”를 알려주는 목록입니다.

  • PATH에 파이썬 경로가 등록되어 있으면:
    • 아무 폴더에서나 명령 프롬프트를 열고 python 만 입력해도 파이썬이 실행됩니다.
  • PATH에 파이썬 경로가 없으면:
    • 파이썬 설치 폴더로 일일이 이동하거나, 전체 경로를 입력해야만 실행됩니다.

초보자는 설치할 때 “Add python.exe to PATH” 옵션을 꼭 체크하는 것이 가장 쉽고 안전한 방법입니다.

파이썬(Python) 설치부터 환경 변수 설정까지 단계별 가이드

1. 파이썬 공식 사이트에서 설치 파일 다운로드

  1. 웹 브라우저(크롬, 엣지 등)를 실행합니다.
  2. 주소창에 https://www.python.org/downloads/ 를 입력해 접속합니다.
  3. 화면 상단에 현재 운영체제를 인식해서 “Download Python 3.x.x” 라는 버튼이 보입니다.
  4. 해당 버튼을 클릭하면 Windows용 최신 파이썬 3 버전 설치 파일(.exe)이 다운로드 됩니다.

여기서 중요한 포인트는, 되도록이면 가장 최신의 안정화된 3.x 버전을 사용하는 것입니다. 대부분의 라이브러리와 튜토리얼이 최신 3.x 기준으로 작성되어 있기 때문에, 굳이 오래된 버전을 쓸 이유가 없습니다.

파이썬 설치

2. 윈도우에서 파이썬 설치 파일 실행

다운로드가 완료되면 Downloads(다운로드) 폴더 등에서 python-3.xx.x-amd64.exe와 같은 이름의 파일을 찾을 수 있습니다.

  1. 설치 파일을 더블 클릭해서 실행합니다.
  2. 첫 화면에서 다음 요소들을 확인합니다.
    • 하단에 “Add Python 3.x to PATH” 체크박스
    • 가운데에 “Install Now”, “Customize installation” 등의 버튼

여기서 초보자에게 가장 중요한 것은 “Add Python 3.x to PATH” 옵션에 반드시 체크하는 것입니다. 이 한 번의 체크로 나중에 환경 변수를 따로 손대지 않아도 됩니다.

  1. 체크를 확인한 뒤 “Install Now” 를 클릭하면 기본 경로(예: C:\Users\사용자명\AppData\Local\Programs\Python\Python3xx)에 파이썬이 설치됩니다.

설치 과정에서 “for all users(모든 사용자용 설치)” 옵션을 선택하는 화면이 보일 수 있는데, 개인 PC라면 기본 사용자 기준 설치를 그대로 진행해도 무방합니다.

3. 설치가 끝났는지 확인하기

설치가 완료되면 “Setup was successful” 또는 이와 유사한 메시지가 나타납니다.
이때 바로 “Close(닫기)” 버튼을 누르기 전에, 아래에 추가적인 옵션(예: “Disable path length limit”)이 있다면 함께 설정해 주면 윈도우에서 긴 경로를 사용할 때 유리합니다.

이제 파이썬이 제대로 설치됐는지 확인해 보겠습니다.

4. 명령 프롬프트에서 파이썬 버전 확인

  1. 윈도우 시작 메뉴에서 cmd 또는 명령 프롬프트를 검색해 실행합니다.
  2. 다음 명령을 입력합니다.
python --version

또는

python -V
  1. 예를 들어 Python 3.13.5 와 같은 형태로 버전 정보가 출력되면 정상적으로 설치 및 PATH 설정이 완료된 것입니다.

만약 'python'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램... 과 같은 오류가 나온다면, 환경 변수에 파이썬 경로가 등록되지 않은 것입니다. 이 경우에는 아래의 “수동 환경 변수 설정” 과정을 진행하면 됩니다.

PATH에 파이썬을 수동으로 추가하는 방법(윈도우)

설치할 때 “Add Python to PATH” 체크를 놓쳤거나, 회사 PC처럼 환경이 제한된 경우에는 직접 환경 변수에 파이썬 경로를 추가해 주어야 합니다.

1. 파이썬 설치 경로 찾기

일반적으로 파이썬은 다음과 같은 경로 중 하나에 설치됩니다.

  • C:\Users\사용자명\AppData\Local\Programs\Python\Python3xx
  • 또는 모든 사용자용 설치 시 C:\Program Files\Python3xx

경로를 정확히 모를 때는 다음 방법이 편합니다.

  1. 시작 메뉴에서 “Python”을 검색합니다.
  2. Python 아이콘에서 오른쪽 클릭 → 파일 위치 열기(Open file location) 를 선택합니다.
  3. 바로가기 아이콘이 있는 폴더가 나오면, 다시 그 바로가기를 오른쪽 클릭해서 **“파일 위치 열기”**를 한 번 더 선택합니다.
  4. 이때 열리는 폴더가 python.exe가 실제 있는 설치 폴더이며, 상단 주소 표시줄의 경로를 복사해 둡니다.

예시 경로:
C:\Users\홍길동\AppData\Local\Programs\Python\Python313

2. 환경 변수 설정 창 열기

  1. 작업 표시줄의 검색창에 “환경 변수” 또는 영어로 **“Edit the system environment variables”**를 입력합니다.
  2. “시스템 환경 변수 편집” 또는 유사한 항목을 클릭합니다.
  3. 열리는 “시스템 속성(System Properties)” 창에서 상단 고급(Advanced) 탭을 선택한 뒤, 하단의 “환경 변수(Environment Variables)” 버튼을 클릭합니다.

환경 변수 창에서는 위쪽의 “사용자 변수(User variables)”와 아래쪽의 “시스템 변수(System variables)” 두 영역을 볼 수 있습니다. 초보자라면 보통 “사용자 변수”의 Path에 추가하는 것으로 충분합니다.

3. 사용자 Path에 파이썬 경로 추가

  1. “사용자 변수” 영역에서 Path 항목을 찾아 선택하고, “편집(Edit)” 버튼을 누릅니다.
  2. 새 창에서 **“새로 만들기(New)”**를 클릭하고, 아까 복사한 파이썬 설치 경로를 붙여 넣습니다.
    • 예: C:\Users\홍길동\AppData\Local\Programs\Python\Python313
  3. 한 번 더 “새로 만들기”를 누르고, 이번에는 Scripts 폴더 경로를 추가합니다.
    • 예: C:\Users\홍길동\AppData\Local\Programs\Python\Python313\Scripts

이 Scripts 경로는 pip를 비롯한 여러 패키지 실행 파일이 위치하는 곳이라, 추가해 두면 전역에서 pip 명령을 편하게 사용할 수 있다는 점이 중요합니다.

  1. 모든 창에서 확인(OK) 을 눌러 설정을 저장합니다.

마지막으로, 새로운 명령 프롬프트 창을 열고 다시 python --version, pip --version 등을 입력해 정상 출력되는지 확인합니다.

초보자가 자주 하는 실수와 알아두면 좋은 팁

1. 설치 파일을 여러 개 깔아 버리는 경우

처음 설치할 때 제대로 안 된 것 같아서 여러 버전의 파이썬을 중복 설치하는 경우가 많습니다. 이렇게 되면 PATH에 등록된 순서에 따라 어떤 버전이 실행될지 헷갈리게 됩니다.

  • 가능하면 하나의 최신 버전만 유지하는 것이 좋습니다.
  • 이전 버전이 필요 없다면 “앱 및 기능”에서 오래된 파이썬을 제거하고, PATH에서 불필요한 경로도 함께 정리합니다.

2. PATH 수정 후 기존 cmd 창에서 계속 테스트하는 경우

환경 변수 변경은 새로 열린 프로세스부터 적용됩니다.

  • PATH를 수정했다면, 기존에 열려 있던 명령 프롬프트 창은 닫고 새 cmd 창을 열어서 재시도해야 합니다.

이 부분을 모르고 “분명히 환경 변수를 고쳤는데 왜 여전히 안 되지?” 하고 고민하는 경우가 많습니다.

3. python 대신 py 명령을 사용하는 방법

윈도우용 파이썬 설치 시, 종종 py 런처가 함께 설치됩니다.

  • py 라고 입력하면 기본 파이썬 버전이 실행됩니다.
  • py -3 처럼 옵션을 주어 버전을 명시할 수도 있습니다.

만약 python 명령이 잘 안 될 때는 py 명령으로 먼저 확인해 보는 것도 한 방법입니다.

4. 설치 후 바로 실행해 볼 “Hello, World!” 예제

설치 확인을 위해 간단한 예제를 실행해 보는 것이 좋습니다.

  1. 바탕화면에 test.py 파일을 하나 만듭니다.
  2. 메모장이나 VS Code를 열어 다음 코드를 입력합니다.
print("Hello, Python!")
  1. 저장 후 명령 프롬프트에서 해당 폴더로 이동해 다음을 실행합니다.
python test.py

“Hello, Python!” 이 출력되면 설치와 PATH 설정까지 모두 정상입니다.

앞으로 무엇을 공부하면 좋을까?

여기까지 진행했다면 파이썬 설치 + 환경 변수 설정 + 간단한 실행 테스트까지 초보자에게 필요한 첫 관문은 모두 통과한 상태입니다.

이제 다음 단계로는 다음과 같은 주제를 이어서 학습해 보시면 좋습니다.

  • 파이썬 기본 문법(변수, 조건문, 반복문, 함수 등)
  • VS Code, PyCharm 같은 IDE 또는 코드 에디터 설치 및 세팅
  • pip를 활용한 외부 라이브러리 설치 방법 (pip install requests 등)

추후 블로그용으로는 “VS Code에서 파이썬 개발 환경 꾸미기”, “가상환경(venv) 설정과 패키지 관리” 같은 주제도 확장해서 다루기 좋습니다.

파이썬 환경을 한 번 제대로 세팅해 두면, 그 위에 데이터 분석이든 크롤링이든 무엇이든 차곡차곡 쌓아 올릴 수 있습니다. 오늘 설명한 설치·환경 변수 설정 과정을 한 번 직접 따라 해 보시고, 바로 다음 글에서는 코드 작성과 실행 연습으로 넘어가 보시길 추천드립니다.

댓글 남기기